IDTExtensibility2.OnConnection - метод

Статья
11/01/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.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.