AddIn.RequestService-Methode (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Gibt ein Objekt zurück, das ein Feature in 2007 Microsoft Office System erweitert.

Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object
'Usage
Dim serviceGuid As Guid
Dim returnValue As Object

returnValue = Me.RequestService(serviceGuid)

protected virtual Object RequestService(
    Guid serviceGuid
)

Parameter

serviceGuid
Typ: System.Guid

Eine Guid, die eine Erweiterbarkeitsschnittstelle angibt, die von Anwendungen in 2007 Microsoft Office System 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 2007 Microsoft Office System erweitert. Weitere Informationen hierzu 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.

Hinweis:
Wird die Benutzeroberfläche der Multifunktionsleiste durch Erstellen der eigenen Implementierung der Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle oder durch Hinzufügen des Elements Multifunktionsleiste (XML) zum Projekt angepasst, überschreiben Sie anstelle der RequestService-Methode die CreateRibbonExtensibilityObject-Methode. Weitere Informationen finden Sie unter Übersicht über die Multifunktionsleiste und unter Multifunktionsleisten-XML.

Wird die Benutzeroberfläche der Multifunktionsleiste durch Erstellen der eigenen Implementierung der Microsoft.Office.Core.IRibbonExtensibility-Schnittstelle oder durch Hinzufügen des Elements Multifunktionsleiste (XML) zum Projekt angepasst, überschreiben Sie anstelle der RequestService-Methode die CreateRibbonExtensibilityObject-Methode. Weitere Informationen finden Sie unter Übersicht über die Multifunktionsleiste und unter 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.

Berechtigungen

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.