Metodo IDTExtensibility2.OnAddInsUpdate

Articolo
08/11/2011

Viene generato ogni volta che un componente aggiuntivo viene caricato o scaricato dall'ambiente di sviluppo integrato (IDE) di Visual Studio.

Spazio dei nomi: Extensibility
Assembly: Extensibility (in Extensibility.dll)

Sintassi

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

Parametri

custom
Tipo: System.Array%
Una matrice vuota che consente di passare i dati specifici relativi all'host da utilizzare nel componente aggiuntivo.

Note

Il metodo viene utilizzato soprattutto per attivare dipendenze in altri componenti aggiuntivi. Se, ad esempio, per l'esecuzione corretta di un componente aggiuntivo è necessario un altro componente aggiuntivo o un altro programma, sarà possibile verificare lo stato tramite questo metodo.

Un componente aggiuntivo genera l'evento OnAddInsUpdate quando, durante una sessione, viene caricato per la prima volta un componente aggiuntivo nell'ambiente e ogni volta che si sceglie OK in Gestione componenti aggiuntivi. La generazione non si verifica se il componente aggiuntivo viene caricato tramite un comando o tramite la proprietà Connected.

Per ottenere il nome del componente aggiuntivo modificato, scorrere l'insieme AddIns e controllare la proprietà Connected di ogni componente aggiuntivo. È possibile accedere a ciascun componente aggiuntivo utilizzando il valore di indice ProgID o con base 1 del componente stesso. Se non esiste alcun indice, viene generato un errore COMException di "indice non valido". Negli altri casi viene restituito un riferimento AddIn.

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.