Método IDTExtensibility2.OnAddInsUpdate

Artigo
05/17/2015

Ocorre sempre que um suplemento é carregada ou descarregado do ambiente de desenvolvimento integrado Visual Studio (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: Array%

Uma matriz vazia que você pode usar para transmitir dados host específicos para uso no suplemento.

Comentários

Esse método é mais usado frequentemente têm dependências no outro suplementos. Ou seja, se um suplemento requer a presença de outro suplemento (ou de outro programa) antes que possa ser executado corretamente, você pode verificar o status com esse método.

Um suplemento aciona o evento de OnAddInsUpdate quando um suplemento é carregado no ambiente pela primeira vez nessa sessão, e sempre que o botão de OK em O gerenciador de suplemento é clicado. Não dispara quando um suplemento é carregado por um comando ou quando for carregado pela propriedade de Connected .

Para obter o nome do suplemento que foi alterada, iteração pela coleção de AddIns e verifique cada um in's adicionam - a propriedade de Connected . Você pode acessar cada suplemento usando sua ProgID ou o valor de índice de base 1. Se o índice não existir, um erro de “COMException de índice inválido” ocorre. Caso contrário, retorna uma referência de AddIn .

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ável.