AddInBase.RequestService - метод

Статья
05/19/2013

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

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

Синтаксис

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

protected virtual Object RequestService(
    Guid serviceGuid
)

Параметры

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

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

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

Заметки

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

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

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

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

Примеры

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

AddInBase Класс

Microsoft.Office.Tools - пространство имен

Другие ресурсы

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

Поделиться через