IDTExtensibility2.OnConnection 方法

项目
09/04/2008

更新：2007 年 11 月

每当向 Visual Studio 中加载外接程序时发生。

命名空间： Extensibility
程序集： Extensibility（在 Extensibility.dll 中）

语法

声明
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
)

参数

Application
类型：System.Object

对集成开发环境 (IDE) 的一个实例 (DTE) 的引用，该实例为 Visual Studio 自动化模型的根对象。

ConnectMode
类型：Extensibility.ext_ConnectMode

一个 ext_ConnectMode 枚举值，指示向 Visual Studio 中加载外接程序的方式。

AddInInst
类型：System.Object

一个对外接程序自己的实例的 AddIn 引用。此引用存储起来以供以后使用（如用于确定外接程序的父集合）。

custom
类型：System.Array%

一个空数组，可用来传递在外接程序中使用的特定于主机的数据。

备注

OnConnection 为 IDTExtensibility2 的 main 方法，这是因为每次加载外接程序时都会调用该方法。该方法为外接程序在加载时的入口点，因此可以将您要在外接程序启动时运行的任何代码放置在此处（或调用任何其他函数）。

示例

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