AddInBase.RequestService-Methode

Artikel
08/10/2011

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.