IDTExtensibility2.OnConnection, méthode

Article
09/04/2008

Mise à jour : novembre 2007

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

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

Syntaxe

Sub OnConnection ( _
    Application As Object, _
    ConnectMode As ext_ConnectMode, _
    AddInInst As Object, _
    ByRef custom As Array _
)

Dim instance As IDTExtensibility2
Dim Application As Object
Dim ConnectMode As ext_ConnectMode
Dim AddInInst As Object
Dim custom As Array

instance.OnConnection(Application, ConnectMode, _
    AddInInst, custom)

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
)

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

Paramètres

Application
Type : System.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 de 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 : System.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 : System.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.");
}

Autorisations

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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.