AddInBase.RequestService(Guid) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.