IDTExtensibility2.OnAddInsUpdate 方法

發行項
10/28/2012

每當 Visual Studio 整合式開發環境 (IDE) 載入或卸載增益集時，便會觸發此事件。

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

語法

'宣告
Sub OnAddInsUpdate ( _
    ByRef custom As Array _
)

void OnAddInsUpdate(
    ref Array custom
)

void OnAddInsUpdate(
    [InAttribute] Array^% custom
)

abstract OnAddInsUpdate : 
        custom:Array byref -> unit

function OnAddInsUpdate(
    custom : Array
)

參數

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

備註

此方法最常用來強制要求與其他增益集的相依性，例如當某個增益集需要另一個增益集 (或其他程式) 存在時才能正常執行，就可以用這個方法檢查其狀態。

當增益集在同一工作階段中第一次載入到環境內，以及使用者按下 [增益集管理員] 中的 [確定] 按鈕時，增益集都會觸發 OnAddInsUpdate 事件。但若透過命令或其增益集的 Connected 屬性將該增益集載入，就不會觸發事件。

若要得知已更動的增益集的名稱，請逐一查看 AddIns 集合中各個增益集的 Connected 屬性。利用增益集的 ProgID 或以 1 起始的索引值，便可存取每一個增益集。當索引不存在時，會發生「無效索引」的 COMException 錯誤，否則將會傳回 AddIn 參考。

範例

Public Sub OnAddInsUpdate(ByRef custom As Array) 
    Try
        Dim addIn As AddIn = applicationObject.AddIns. _
        Item("MyAddin1.Connect")
        If addInInstance.Connected = True Then
            System.Windows.Forms.MessageBox.Show("This add-in is _
            connected.")
        Else
            System.Windows.Forms.MessageBox.Show("This add-in is not _
            connected.")
        End If
    Catch ex As Runtime.Interop.COMException
        System.Windows.Forms.MessageBox.Show("Not a registered add- _
        in.")
    End Try
End Sub

public void OnAddInsUpdate(ref Array custom)
{
    try
    {
        AddIn addIn = this.dte.addins.item("MyAddin1.Connect");
        if (addInInstance.Connected == true)
        {
            System.Windows.Forms.MessageBox.Show("This add-in is 
            connected.");
        }
        else
        {
            System.Windows.Forms.MessageBox.Show("This add-in is not 
            connected.");
        }
    }

    catch (COMException)
    {
         System.Windows.Forms.MessageBox.Show("Not a registered add-
         in.");
    }
}