Metodo IDTExtensibility2.OnConnection

Articolo
10/30/2012

Si verifica ogni volta che un componente aggiuntivo viene caricato in Visual Studio.

Spazio dei nomi: Extensibility
Assembly: Extensibility (in Extensibility.dll)

Sintassi

'Dichiarazione
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
)

Parametri

Application
Tipo: System.Object
Un riferimento a un'istanza dell'ambiente di sviluppo integrato (IDE) (IDE), DTE, che rappresenta l'oggetto radice di Visual Studio modello di automazione.

ConnectMode
Tipo: Extensibility.ext_ConnectMode
ext_ConnectMode il valore di enumerazione che indica il modo in cui il componente aggiuntivo è stato caricato in Visual Studio.

AddInInst
Tipo: System.Object
AddIn riferimento a un oggetto business personalizzati istanza.Ciò viene salvata per un utilizzo successivo, quale la determinazione della raccolta padre per il componente aggiuntivo.

custom
Tipo: System.Array%
Una matrice vuota che è possibile utilizzare per passare i dati host-specifici da utilizzare nel componente aggiuntivo.

Note

OnConnection è il metodo main per IDTExtensibility2, poiché viene chiamato ogni volta che un componente aggiuntivo viene caricato.È il punto di ingresso per un componente aggiuntivo quando viene caricato, pertanto è possibile inserire tutto il codice seguente (o chiamare qualsiasi altra funzione) che si desidera eseguire all'avvio del componente aggiuntivo.

Esempi

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.");
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.