ObjectExtenders.RegisterExtenderProvider (Método)

Artículo
08/10/2011

Registra un Proveedor extensor para una categoría Extender específica.

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

Sintaxis

'Declaración
Function RegisterExtenderProvider ( _
    ExtenderCATID As String, _
    ExtenderName As String, _
    ExtenderProvider As IExtenderProvider, _
    LocalizedName As String _
) As Integer

int RegisterExtenderProvider(
    string ExtenderCATID,
    string ExtenderName,
    IExtenderProvider ExtenderProvider,
    string LocalizedName
)

int RegisterExtenderProvider(
    [InAttribute] String^ ExtenderCATID, 
    [InAttribute] String^ ExtenderName, 
    [InAttribute] IExtenderProvider^ ExtenderProvider, 
    [InAttribute] String^ LocalizedName
)

abstract RegisterExtenderProvider : 
        ExtenderCATID:string * 
        ExtenderName:string * 
        ExtenderProvider:IExtenderProvider * 
        LocalizedName:string -> int

function RegisterExtenderProvider(
    ExtenderCATID : String, 
    ExtenderName : String, 
    ExtenderProvider : IExtenderProvider, 
    LocalizedName : String
) : int

Parámetros

ExtenderCATID
Tipo: System.String
Obligatorio.CATID del objeto Extender.

ExtenderName
Tipo: System.String
Obligatorio.Nombre del objeto Extender.Se trata del nombre del objeto Extender asignado mediante programación y se utiliza en la llamada a GetExtender.

ExtenderProvider
Tipo: EnvDTE.IExtenderProvider
Obligatorio.El proveedor extensor que implementa la interfaz IExtenderProvider.

LocalizedName
Tipo: System.String
Opcional.Traducción (localización) del nombre para mostrar del objeto Extender.

Valor devuelto

Tipo: System.Int32
Una cookie con valor entero que identifica el registro.Esta cookie se debe devolver durante la ejecución del método UnregisterExtenderProvider.

Comentarios

Un proveedor extensor utiliza RegisterExtenderProvider para registrarse dinámicamente con el objeto ObjectExtenders bajo un Id. de categoría y un nombre específicos. Un proveedor extensor puede registrar más de un objeto Extender bajo uno o más Id. de categoría.

Hay dos formas de registrar proveedores extensores:

Estáticamente, en la subclave apropiada de Id. de categoría del extensor en la clave de Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders, durante la instalación del complemento.
Dinámicamente, llamando a este método en el método OnConnection de un complemento.

Nota

Los proveedores extensores de registro dinámico deben anular su registro llamando al método UnregisterExtenderProvider al cerrar. Los proveedores extensores de registro estático no deben hacerlo.

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.