AddInBase.RequestService-Methode

Artikel
05/07/2013

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 für 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.

Hinweis
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.

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

AddInBase Klasse

Microsoft.Office.Tools-Namespace

Weitere Ressourcen

Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen

Freigeben über