IDTExtensibility2.OnConnection, méthode

Article
05/16/2015

Se produit lorsqu'un complément est chargé dans Visual Studio.

Espace de noms : Extensibility
Assembly : Extensibility (dans Extensibility.dll)

Syntaxe

'Déclaration
Sub OnConnection ( _
    Application As Object, _
    ConnectMode As ext_ConnectMode, _
    AddInInst As Object, _
    ByRef custom As Array _
)

void OnConnection(
    Object Application,
    ext_ConnectMode ConnectMode,
    Object AddInInst,
    ref Array custom
)

void OnConnection(
    [InAttribute] Object^ Application, 
    [InAttribute] ext_ConnectMode ConnectMode, 
    [InAttribute] Object^ AddInInst, 
    [InAttribute] Array^% custom
)

abstract OnConnection : 
        Application:Object * 
        ConnectMode:ext_ConnectMode * 
        AddInInst:Object * 
        custom:Array byref -> unit

function OnConnection(
    Application : Object, 
    ConnectMode : ext_ConnectMode, 
    AddInInst : Object, 
    custom : Array
)

Paramètres

Application
Type : Object

Référence à une instance de l'environnement de développement intégré (IDE), DTE qui est l'objet racine du modèle Automation Visual Studio.

ConnectMode
Type : Extensibility.ext_ConnectMode

Valeur d'énumération ext_ConnectMode qui indique la façon dont le complément a été chargé dans Visual Studio.

AddInInst
Type : Object

Référence AddIn à l'instance du complément. Elle est stockée pour une utilisation ultérieure, par exemple pour déterminer la collection parente du complément.

custom
Type : Array%

Tableau vide que vous pouvez utiliser afin de passer des données propres à un hôte pour une utilisation dans le complément.

Notes

OnConnection est la principale méthode pour IDTExtensibility2, car elle est appelée chaque fois qu'un complément est chargé. Il s'agit du point d'entrée d'un complément lorsqu'il est chargé ; vous pouvez donc placer ici tout code (ou appeler une autre fonction) que vous souhaitez exécuter lorsque le complément démarre.

Exemples

Public Sub OnConnection(ByVal application As Object, ByVal _
connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    applicationObject = CType(application, DTE2)
    addInInstance = CType(addInInst, AddIn)
    MsgBox("Add-in is connected.")
End Sub

public void OnConnection(object application, ext_ConnectMode 
connectMode, object addInInst, ref Array custom)
{
    applicationObject = (DTE2)application;
    addInInstance = (AddIn)addInInst;
    System.Windows.Forms.MessageBox.Show("Add-in has connected.");
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.