Metodo ObjectExtenders.RegisterExtenderProvider

Articolo
08/11/2011

Registra un provider di estensione per una categoria Extender specifica.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

ExtenderCATID
Tipo: System.String
Obbligatorio.Il CATID dell'estensione.

ExtenderName
Tipo: System.String
Obbligatorio.Il nome dell'Extender.Si tratta del nome a livello di codice dell'Extender e viene utilizzato nella chiamata a GetExtender.

ExtenderProvider
Tipo: EnvDTE.IExtenderProvider
Obbligatorio.Provider Extender che implementa l'interfaccia IExtenderProvider.

LocalizedName
Tipo: System.String
Facoltativo.Il nome localizzato che viene visualizzato per l'estensione.

Valore restituito

Tipo: System.Int32
Cookie con valore intero che identifica la registrazione.Questo cookie deve essere restituito durante UnregisterExtenderProvider.

Note

RegisterExtenderProvider viene utilizzato dal provider Extender per registrarsi dinamicamente sotto un CATID e un nome particolari con l'oggetto ObjectExtenders. Un provider Extender consente la registrazione di più oggetti Extender sotto uno o più CATID.

È possibile registrare i provider Extender in due modi diversi:

In modo statico, nella sottochiave del CATID dell'Extender appropriato incluso nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders durante l'installazione del componente aggiuntivo.
In modo dinamico, chiamando questo metodo in un metodo OnConnection del componente aggiuntivo.

Nota

I provider Extender registrati dinamicamente devono annullare la propria registrazione eseguendo la chiamata a UnregisterExtenderProvider al momento della chiusura. Questa operazione non viene eseguita nei provider registrati in modo statico.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.