IDTExtensibility2.OnAddInsUpdate, méthode

Article
05/16/2015

Se produit lorsqu'un complément est chargé ou déchargé de l'environnement de développement intégré (IDE, Integrated Development Environment) Visual Studio.

Espace de noms : Extensibility
Assembly : Extensibility (dans Extensibility.dll)

Syntaxe

'Déclaration
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
)

Paramètres

custom
Type : Array%

Tableau vide que vous pouvez utiliser afin de passer des données propres à un hôte pour une utilisation dans le complément.

Notes

Cette méthode est le plus souvent utilisée pour appliquer des dépendances sur d'autres compléments. En d'autres termes, si un complément nécessite la présence d'un autre complément (ou d'un autre programme) pour pouvoir s'exécuter correctement, vous pouvez vérifier l'état avec cette méthode.

Un complément déclenche l'événement OnAddInsUpdate lorsqu'il se charge pour la première fois de la session concernée dans l'environnement et chaque fois que l'utilisateur clique sur le bouton OK du Gestionnaire de compléments. L'événement n'est pas déclenché lorsqu'un complément est chargé par une commande ou lorsqu'il est chargé par sa propriété Connected.

Pour obtenir le nom du complément qui a été modifié, itérez au sein de la collection AddIns et vérifiez la propriété Connected de chaque complément. Vous pouvez accéder à chaque complément en utilisant son ProgID ou sa valeur d'index de base 1. Si l'index n'existe pas, une erreur COMException "index non valide" se produit. Sinon, une référence AddIn est retournée.

Exemples

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.