IDTExtensibility2.OnConnection (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

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

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

Sintaxis

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
)

Parámetros

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

Permisos

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.