Metodo IDTExtensibility2.OnConnection

Articolo
08/11/2011

Viene generato 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), DTE, che è l'oggetto radice del modello di automazione di Visual Studio.

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

AddInInst
Tipo: System.Object
Un riferimento AddIn all'istanza propria del componente aggiuntivo.Questa viene memorizzata per eventuali utilizzi successivi, quale ad esempio la determinazione dell'insieme principale.

custom
Tipo: System.Array%
Una matrice vuota che consente di passare i dati specifici relativi all'host da utilizzare nel componente aggiuntivo.

Note

OnConnection è il metodo principale per IDTExtensibility2, poiché viene chiamato a ogni caricamento di un componente aggiuntivo. Si tratta del punto di ingresso di un componente aggiuntivo che viene caricato, di conseguenza è possibile immettere in questa posizione eventuali codici o chiamare un'altra funzione che si intende 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.