AddInBase.RequestService(Guid) Methode

Definition

Gibt ein Objekt zurück, das eine Funktion in einer Microsoft Office-Anwendung erweitert.

protected virtual object RequestService (Guid serviceGuid);

Parameter

serviceGuid
Guid

Eine Guid, die eine von Microsoft Office-Anwendungen unterstützte Erweiterbarkeitsschnittstelle identifiziert.

Gibt zurück

Object

Ein Objekt, das die von serviceGuid identifizierte Erweiterbarkeitsschnittstelle implementiert.

Implementiert

Beispiele

Ein Codebeispiel, in dem veranschaulicht wird, wie eine Erweiterbarkeits Schnittstelle implementiert und die-Methode überschrieben RequestService wird, finden Sie unter Anpassen von Funktionen der Benutzeroberfläche mithilfe von Erweiterbarkeits Schnittstellen.

Hinweise

Überschreiben Sie diese Methode in einem Add-in auf Anwendungsebene, um eine Erweiterbarkeits Schnittstelle zu implementieren, die eine Funktion in einer Microsoft Office Anwendung erweitert. Weitere Informationen finden Sie unter Customizing UI Features By Using Extensibility Interfaces.

Wenn Sie diese Methode überschreiben, überprüfen Sie den Wert des- serviceGuid Parameters, um zu bestimmen, welche Erweiterbarkeits Schnittstelle angefordert wird, und geben Sie dann ein Objekt zurück, das die-Schnittstelle implementiert. Wenn das Add-in geladen wird, Visual Studio-Tools für Office-Laufzeit Ruft das RequestService einmal oder mehrere Male für jede Schnittstelle auf, die von der Anwendung unterstützt wird, und sendet den Rückgabewert an die Microsoft Office Anwendung, die das Add-in lädt. Weitere Informationen zum Ladevorgang von Add-Ins finden Sie unter Architektur von VSTO-Add-ins.

Hinweis

Wenn Sie die Multifunktionsleisten-Benutzeroberfläche anpassen, indem Sie eine eigene Implementierung der- Microsoft.Office.Core.IRibbonExtensibility Schnittstelle erstellen oder dem Projekt ein Menüband (XML) -Element hinzufügen, können Sie alternativ die- CreateRibbonExtensibilityObject Methode anstelle der-Methode überschreiben RequestService . Weitere Informationen finden Sie unter Übersicht über das Menüband und Menüband-XML.

Gilt für: