Método IDTExtensibility2.OnConnection

Artigo
08/01/2011

Ocorre sempre que um suplemento é carregado na Visual Studio.

Namespace: Extensibility
Assembly: Extensibility (em Extensibility.dll)

Sintaxe

'Declaração
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: System.Object
Uma referência a uma instância do ambiente de desenvolvimento integrado (IDE), DTE, que é o objeto raiz da Visual Studio modelo de automação.

ConnectMode
Tipo: Extensibility.ext_ConnectMode
Um ext_ConnectMode o valor de enumeração que indica a maneira como o suplemento foi carregado no Visual Studio.

AddInInst
Tipo: System.Object
Um AddIn referência ao suplemento da própria instância.Isso é armazenado para uso posterior, tais como determinar a coleção do pai para o suplemento.

custom
Tipo: System.Array%
Uma matriz vazia que você pode usar para passar dados de host específicos para usar o add-in.

Comentários

OnConnectioné o principal método para IDTExtensibility2, porque ele é chamado sempre que um suplemento é carregado. É o ponto de entrada para um suplemento quando ele for carregado, portanto, você pode colocar qualquer código aqui (ou chamar qualquer outra função) que você deseja executar quando o add-in for iniciado.

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.