Freigeben über


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

HinweisHinweis

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

Siehe auch

Referenz

AddInBase Klasse

Microsoft.Office.Tools-Namespace

Weitere Ressourcen

Anpassen von Features der Benutzeroberfläche mithilfe von Erweiterungsschnittstellen