Condividi tramite


Metodo AddInBase.RequestService

Restituisce un oggetto che estende una funzionalità in un'applicazione di Microsoft Office.

Spazio dei nomi:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object
protected virtual Object RequestService(
    Guid serviceGuid
)

Parametri

  • serviceGuid
    Tipo: System.Guid
    Oggetto Guid che identifica un'interfaccia di estensibilità supportata dalle applicazioni Microsoft Office.

Valore restituito

Tipo: System.Object
Oggetto che implementa l'interfaccia di estensibilità identificata da serviceGuid.

Note

Eseguire l'override di questo metodo in un componente aggiuntivo a livello di applicazione per implementare un'interfaccia di estensibilità che amplia una funzionalità di un'applicazione di Microsoft Office. Per ulteriori informazioni, vedere Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità.

Quando si esegue l'override di questo metodo, verificare il valore del parametro serviceGuid per determinare l'interfaccia di estensibilità necessaria e quindi restituire un oggetto che implementa l'interfaccia. Quando il componente aggiuntivo viene caricato, attraverso il Runtime di Visual Studio Tools per Office vengono effettuate una o più chiamate all'oggetto RequestService per ciascuna interfaccia supportata dall'applicazione e viene inviato il valore restituito all'applicazione di Microsoft Office in cui viene caricato il componente aggiuntivo. Per ulteriori informazioni sul processo di caricamento dei componenti aggiuntivi, vedere Architettura dei componenti aggiuntivi a livello di applicazione.

Nota

Se l'interfaccia utente della barra multifunzione viene personalizzata mediante la creazione di un'implementazione propria dell'interfaccia Microsoft.Office.Core.IRibbonExtensibility o l'aggiunta di un elemento Barra multifunzione (XML) al progetto, è possibile eseguire l'override del metodo CreateRibbonExtensibilityObject anziché del metodo RequestService. Per ulteriori informazioni, vedere Cenni preliminari sulla barra multifunzione e Elemento XML della barra multifunzione.

Esempi

Per un esempio di codice che illustra come implementare un'interfaccia di estensibilità ed eseguire l'override del metodo RequestService, vedere Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità.

Sicurezza di .NET Framework

Vedere anche

Riferimenti

AddInBase Classe

Spazio dei nomi Microsoft.Office.Tools

Altre risorse

Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità