IDTExtensibility2.OnConnection-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Tritt ein, wenn ein Add-In in Visual Studio geladen wird.

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

Syntax

'Declaration
Sub OnConnection ( _
    Application As Object, _
    ConnectMode As ext_ConnectMode, _
    AddInInst As Object, _
    ByRef custom As Array _
)
'Usage
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
)

Parameter

Application
Typ: System.Object

Ein Verweis auf DTE, eine Instanz der integrierten Entwicklungsumgebung (IDE), die das Stammobjekt des Visual Studio-Automatisierungsmodells darstellt.

ConnectMode
Typ: Extensibility.ext_ConnectMode

Ein Wert einer ext_ConnectMode-Enumeration, der angibt, wie das Add-In in Visual Studio geladen wurde.

AddInInst
Typ: System.Object

Ein AddIn-Verweis auf die eigene Instanz des Add-Ins. Dieser wird für die spätere Verwendung gespeichert, z. B. um die übergeordnete Auflistung für das Add-In zu bestimmen.

custom
Typ: System.Array%

Ein leeres Array zur Übergabe hostspezifischer Daten, die im Add-In verwendet werden.

Hinweise

OnConnection ist die Hauptmethode für IDTExtensibility2, da sie bei jedem Laden eines Add-Ins aufgerufen wird. Sie bildet beim Laden den Einstiegspunkt für ein Add-In, sodass Sie hier beliebigen Code einfügen bzw. eine andere Funktion aufrufen können, der bzw. die beim Starten des Add-Ins ausgeführt werden soll.

Beispiele

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.