Metoda IDTExtensibility2.OnAddInsUpdate —

Artykuł
05/17/2015

Występuje zawsze, gdy dodatek jest załadowane lub wyładowane ze Visual Studio zintegrowane środowisko programistyczne (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: Array%

Pusta tablica, który służy do przekazywania danych specyficznych dla hosta do użycia w dodatku.

Uwagi

Metoda ta jest najczęściej używany w celu wymuszenia zależności na inne dodatki.To znaczy 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 dodatek OnAddInsUpdate zdarzenia dodatków załaduje w środowisku po raz pierwszy w danej sesji i przy każdym OK przycisk w Add-In Manager zostanie kliknięty.Nie powoduje wyzwolenia, gdy dodatek jest ładowany za pomocą polecenia lub po jego załadowaniu na jego Connected właściwości.

Aby uzyskać nazwę dodatek, który uległ zmianie, iterację AddIns kolekcji i sprawdzanie każdego add-in Connected właściwości.Każdy dodatek można uzyskać dostęp przy użyciu jej identyfikatora ProgID lub wartość indeksu rozpoczynającego się od 1.Jeśli indeks istnieje, występuje błąd COMException "Nieprawidłowy indeks".W przeciwnym wypadku 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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.