Método IDTExtensibility2.OnAddInsUpdate

Artigo
10/26/2012

Ocorre sempre que um suplemento é carregado ou descarregado a partir do Visual Studio o ambiente de desenvolvimento integrado (IDE).

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

Sintaxe

'Declaração
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
)

Parâmetros

custom
Tipo: System.Array%
Uma matriz vazia que você pode usar para passar dados específica do host para usar o add-in.

Comentários

Este método é usado com mais freqüência para impor as dependências em outros suplementos.Ou seja, se um add-in requer a presença de outro suplemento (ou outro programa) antes de ele pode ser executado corretamente, você pode verificar o status com esse método.

Disparadores um add-in a OnAddInsUpdate evento quando um suplemento é carregado no ambiente pela primeira vez nessa sessão e sempre que o OK botão no Gerenciador de suplementos é clicado.Ele não dispara quando um suplemento é carregado por um comando ou quando ele for carregado por meio de sua Connected propriedade.

Para obter o nome do suplemento que mudou, iterar por meio de AddIns coleção e verificar cada do suplemento Connected propriedade.Você pode acessar cada suplemento usando o seu valor de índice baseado em 1 ou ProgID.Se o índice não existir, ocorrerá um erro de COMException de "índice inválido".Caso contrário, ele retorna um AddIn referência.

Exemplos

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.