Método IDTExtensibility2.OnConnection

Artigo
05/17/2015

Ocorre sempre que um suplemento é carregado em 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: Object

Uma referência a uma instância do ambiente de desenvolvimento integrado (IDE), DTE, que é o objeto raiz do modelo de automação de Visual Studio .

ConnectMode
Tipo: Extensibility.ext_ConnectMode

Um valor de enumeração ext_ConnectMode que indica a maneira como o suplemento foi carregado em Visual Studio.

AddInInst
Tipo: Object

Uma referência de AddIn adicionar - in's própria instância. Isso é armazenado para uso posterior, conforme a determinação da coleção pai para o suplemento.

custom
Tipo: Array%

Uma matriz vazia que você pode usar para transmitir dados host específicos para uso no suplemento.

Comentários

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

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ável.