AddInBase.RequestService メソッド
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
Microsoft Office アプリケーションでサポートされている機能拡張インターフェイスを識別する Guid。
戻り値
型 : System.Object
serviceGuid によって識別される機能拡張インターフェイスを実装するオブジェクト。
解説
Microsoft Office アプリケーションの機能を拡張する機能拡張インターフェイスを実装するには、アプリケーション レベルのアドインでこのメソッドをオーバーライドします。詳細については、「機能拡張インターフェイスによる UI 機能のカスタマイズ」を参照してください。
このメソッドをオーバーライドする場合は、serviceGuid パラメーターの値を確認して必要な機能拡張インターフェイスを特定し、インターフェイスを実装するオブジェクトを返します。アドインが読み込まれるとき、Visual Studio Tools for Office Runtime は、アプリケーションによってサポートされているインターフェイスごとに RequestService を 1 回以上呼び出し、アドインを読み込んでいる Microsoft Office アプリケーションに戻り値を送信します。アドインの読み込みプロセスの詳細については、「アプリケーション レベルのアドインのアーキテクチャ」を参照してください。
[!メモ]
リボン UI を、Microsoft.Office.Core.IRibbonExtensibility インターフェイスの独自の実装を作成する、またはリボン (XML) 項目をプロジェクトに追加することでカスタマイズしている場合は、RequestService メソッドの代わりに CreateRibbonExtensibilityObject メソッドをオーバーライドできます。詳細については、「リボンの概要」および「リボン XML」を参照してください。
例
機能拡張インターフェイスを実装し、RequestService メソッドをオーバーライドする方法を示すコード例については、「機能拡張インターフェイスによる UI 機能のカスタマイズ」を参照してください。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。