AddIn.RequestService Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает объект, который расширяет функции в системе 2007 Microsoft Office.

Пространство имен: Microsoft.Office.Tools
Сборка: Microsoft.Office.Tools.Common.v9.0 (в Microsoft.Office.Tools.Common.v9.0.dll)

Синтаксис

'Декларация
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object
'Применение
Dim serviceGuid As Guid
Dim returnValue As Object

returnValue = Me.RequestService(serviceGuid)

protected virtual Object RequestService(
    Guid serviceGuid
)

Параметры

serviceGuid
Тип: System.Guid
Guid , которая определяет интерфейс расширения, поддерживаемый приложениями системы Microsoft Office 2007.

Возвращаемое значение

Тип: System.Object
Объект, который реализует интерфейс расширения, определяемый с помощью serviceGuid.

Заметки

Переопределите этот метод в надстройке уровня приложения для реализации интерфейса расширения, который расширяет функции системы Microsoft Office 2007. Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости.

При переопределении этого метода проверьте значение параметра serviceGuid, чтобы определить, какой интерфейс расширения необходимо запросить, а затем вернуть объект, который реализует этот интерфейс. При загрузке надстроек Visual Studio Tools for Office среда выполнения вызывает RequestService один или несколько раз для каждого интерфейса, поддерживаемого приложением, а затем направляет возвращаемое значение приложению Microsoft Office, которое загружает надстройку. Дополнительные сведения о процессе загрузки надстроек см. в разделе Архитектура надстроек уровня приложения.

Примечание.
При настройке ленты как части пользовательского интерфейса путем создания собственной реализации интерфейса Microsoft.Office.Core.IRibbonExtensibility или путем добавления в проект элемента Ribbon (XML) вместо метода RequestService также можно переопределить метод CreateRibbonExtensibilityObject. Дополнительные сведения см. в разделах Обзор ленты и XML-ленты.

При настройке ленты как части пользовательского интерфейса путем создания собственной реализации интерфейса Microsoft.Office.Core.IRibbonExtensibility или путем добавления в проект элемента Ribbon (XML) вместо метода RequestService также можно переопределить метод CreateRibbonExtensibilityObject. Дополнительные сведения см. в разделах Обзор ленты и XML-ленты.

Примеры

В следующем примере кода показывается, как реализовать интерфейс расширения и переопределить метод RequestService см. раздел Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.