IDTExtensibility2.OnConnection (Método)

Artículo
05/17/2015

Se produce siempre que se carga un complemento en Visual Studio.

Espacio de nombres: Extensibility
Ensamblado: Extensibility (en Extensibility.dll)

Sintaxis

'Declaración
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
)

Parámetros

Application
Tipo: Object

Referencia a una instancia del entorno de desarrollo integrado (IDE), DTE, que es el objeto raíz del modelo de automatización de Visual Studio.

ConnectMode
Tipo: Extensibility.ext_ConnectMode

Valor de enumeración ext_ConnectMode que indica la manera en que se cargó el complemento en Visual Studio.

AddInInst
Tipo: Object

Referencia AddIn a la propia instancia del complemento. Se almacena para usos posteriores, como, por ejemplo, para determinar la colección primaria del complemento.

custom
Tipo: Array%

Matriz vacía que puede utilizarse para pasar datos específicos del host para su uso en el complemento.

Comentarios

OnConnection es el método principal para IDTExtensibility2, ya que recibe una llamada cada vez que se carga un complemento. Es el punto de entrada de un complemento al cargarse, por lo que puede utilizarse para colocar código (o llamar a otra función) que se desee ejecutar cuando se inicie el complemento.

Ejemplos

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.