Método IDTExtensibility2.OnAddInsUpdate

Artigo
08/01/2011

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 de host específicos para usar o add-in.

Comentários

Este método é freqüentemente usado 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 que ele pode ser executado corretamente, você pode verificar o status com este método.

Disparadores um add-in do OnAddInsUpdate evento quando um suplemento é carregado no ambiente pela primeira vez em que a 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 add-in Connected propriedade. Você pode acessar cada suplemento usando o seu valor de índice baseado em 1 ou ProgID. Se o índice não existir, um "índice inválido" Erro de COMException ocorre. Caso contrário, retorna um AddIn de 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.