Metoda IDTExtensibility2.OnAddInsUpdate —

Artykuł
10/27/2012

Występuje zawsze, gdy dodatek jest załadowane lub wyładowane ze Visual Studio zintegrowane środowisko dewelopowania (IDE).

Przestrzeń nazw: Extensibility
Zestaw: Extensibility (w Extensibility.dll)

Składnia

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

Parametry

custom
Typ: System.Array%
Pustą tablicę, którego można przekazywać dane specyficzne dla hosta do użytku w dodatku.

Uwagi

Metoda ta jest najczęściej używany w celu wymuszenia zależnościami w innych dodatków.Oznacza to, że jeśli dodatek wymaga obecności inny dodatek (lub inny program) zanim można uruchomić prawidłowo, można sprawdzić stan przy użyciu tej metody.

Wyzwalacze w OnAddInsUpdate zdarzenia Dodaj w ładuje w środowisku po raz pierwszy w danej sesji i zawsze, gdy OK przycisku w - W Menedżerze zostanie kliknięty.Nie powoduje wyzwolenia gdy dodatek jest ładowany za pomocą polecenia lub jest ładowany w drodze jego Connected właściwości.

Aby uzyskać nazwę dodatku, który uległ zmianie, iterację AddIns gromadzenia i sprawdzania każdego dodatku w Connected właściwości.Każdego dodatku można uzyskać dostęp przy użyciu jej identyfikatora ProgID albo wartość indeksu opartego na 1.Jeśli indeks nie istnieje, występuje błąd "Nieprawidłowy indeks" COMException.W przeciwnym razie zwraca AddIn odniesienia.

Przykłady

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..