IDTExtensibility2.OnAddInsUpdate-Methode

Artikel
05/16/2015

Tritt ein, wenn ein Add-In in die integrierte Entwicklungsumgebung (IDE) von Visual Studio geladen bzw. daraus entladen wird.

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

Syntax

'Declaration
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
)

Parameter

custom
Typ: Array%

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

Hinweise

Diese Methode wird meistens zur Durchsetzung von Abhängigkeiten für andere Add-Ins verwendet. Wenn ein Add-In also ein anderes Add-In (bzw. ein anderes Programm) benötigt, um ordnungsgemäß ausgeführt zu werden, können Sie mithilfe dieser Methode den Status überprüfen.

Durch ein Add-In wird das OnAddInsUpdate-Ereignis ausgelöst, wenn ein Add-In innerhalb einer Sitzung erstmalig in der Umgebung geladen wird und sobald im Add-In-Manager auf die Schaltfläche OK geklickt wird. Das Ereignis wird nicht ausgelöst, wenn ein Add-In durch einen Befehl oder über seine Connected-Eigenschaft geladen wird.

Um den Namen des Add-Ins herauszufinden, das geändert wurde, durchlaufen Sie die AddIns-Auflistung und überprüfen die Connected-Eigenschaft jedes Add-Ins. Sie können auf die einzelnen Add-Ins zugreifen, indem Sie entweder die zugehörige ProgID oder einen 1-basierten Indexwert verwenden. Wenn der Index nicht vorhanden ist, tritt der ComException-Fehler "Ungültiger Index" auf. Andernfalls wird ein AddIn-Verweis zurückgegeben.

Beispiele

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

.NET Framework-Sicherheit

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.