AddInBase.RequestService-Methode
Gibt ein Objekt zurück, das ein Feature in einer Microsoft Office-Anwendung erweitert.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Syntax
'Declaration
Protected Overridable Function RequestService ( _
serviceGuid As Guid _
) As Object
protected virtual Object RequestService(
Guid serviceGuid
)
Parameter
- serviceGuid
Typ: System.Guid
Eine Guid, die eine Erweiterbarkeitsschnittstelle angibt, die von Microsoft Office-Anwendungen unterstützt wird.
Rückgabewert
Typ: System.Object
Ein Objekt, das die Erweiterbarkeitsschnittstelle implementiert, die von serviceGuid angegeben wird.
Hinweise
Überschreiben Sie diese Methode in einem Add-In auf Anwendungsebene, um eine Erweiterbarkeitsschnittstelle zu implementieren, die ein Feature in einer Microsoft Office-Anwendung erweitert. Weitere Informationen finden Sie unter Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen.
Wenn Sie diese Methode überschreiben, überprüfen Sie den Wert des serviceGuid-Parameters, um zu bestimmen, welche Erweiterbarkeitsschnittstelle angefordert wird, und geben Sie dann ein Objekt zurück, das die Schnittstelle implementiert. Wenn das Add-In geladen ist, ruft die Visual Studio Tools for Office-Laufzeit mindestens einmal für jede von der Anwendung unterstützte Schnittstelle RequestService auf und sendet den Rückgabewert an die Microsoft Office-Anwendung, von der das Add-In geladen wird. Weitere Informationen zum Laden von Add-Ins finden Sie unter Architektur von Add-Ins auf Anwendungsebene.
Tipp
Wird die Benutzeroberfläche des Menübands durch Erstellen der eigenen Implementierung der Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle oder durch Hinzufügen des Elements Menüband (XML) zum Projekt angepasst, überschreiben Sie anstelle der CreateRibbonExtensibilityObject-Methode die RequestService-Methode. Weitere Informationen finden Sie unter Übersicht über die Multifunktionsleiste und Multifunktionsleisten-XML.
Beispiele
Ein Codebeispiel, in dem das Implementieren einer Erweiterbarkeitsschnittstelle und das Überschreiben der RequestService-Methode beschrieben wird, finden Sie unter Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
Microsoft.Office.Tools-Namespace
Weitere Ressourcen
Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen