IDTExtensibility2.OnConnection 方法

發行項
10/28/2012

每當在 Visual Studio 載入增益集時，就會觸發此事件。

命名空間： Extensibility
組件： Extensibility (在 Extensibility.dll 中)

語法

'宣告
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
)

參數

Application
型別：System.Object
整合式開發環境 (IDE) DTE 執行個體的參考，是 Visual Studio Automation 模型的根物件。

ConnectMode
型別：Extensibility.ext_ConnectMode
ext_ConnectMode 列舉值，指出在 Visual Studio 中載入增益集的方式。

AddInInst
型別：System.Object
增益集本身執行個體的 AddIn 參考，暫時儲存起來以便稍後使用，例如要判斷此增益集的父集合時便可使用。

custom
型別：System.Array%
空白陣列，可以用來傳遞用於增益集中的特定裝載程式資料。

備註

OnConnection 是 IDTExtensibility2 的主要方法，因為每次載入增益集時都會呼叫它。當增益集載入時，這個方法是增益集的進入點，因此可以將增益集啟動時應執行的任何程式碼或應呼叫的其他任何函數放在這裡。

範例

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