IDTExtensibility2.OnAddInsUpdate (Método)

Artículo
05/17/2015

Se produce siempre que se carga o descarga un complemento desde el entorno de desarrollo integrado (IDE) de Visual Studio.

Espacio de nombres: Extensibility
Ensamblado: Extensibility (en Extensibility.dll)

Sintaxis

'Declaración
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%

Matriz vacía que puede utilizarse para pasar datos específicos del host para su uso en el complemento.

Comentarios

Este método suele utilizarse para forzar dependencias en otros complementos. Así, si un complemento requiriera la presencia de otro (u otro programa) para poder ejecutarse correctamente, podría comprobarse el estado con este método.

Un complemento desencadena el evento OnAddInsUpdate cuando otro complemento se carga en el entorno por primera vez en la sesión y siempre que se hace clic en el botón Aceptar en el Administrador de complementos. Sin embargo, no lo desencadena cuando la carga se debe a un comando o cuando se realiza por medio de la propiedad Connected del complemento.

Para obtener el nombre del complemento que ha cambiado, es necesario recorrer en iteración la colección AddIns y comprobar la propiedad Connected de cada complemento. El acceso a cada complemento puede realizarse mediante su identificador de programa (ProgID) o su valor de índice de base 1. Si el índice no existiera, se producirá un error de COMException: "índice no válido". En caso contrario, se devolverá una referencia AddIn.

Ejemplos

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.