IExtenderProviderUnk.GetExtender メソッド
指定されたカテゴリにある、指定されたオブジェクトのエクステンダーを返します。
名前空間: EnvDTE
アセンブリ: EnvDTE (EnvDTE.dll 内)
構文
'宣言
Function GetExtender ( _
ExtenderCATID As String, _
ExtenderName As String, _
ExtendeeObject As Object, _
ExtenderSite As IExtenderSite, _
Cookie As Integer _
) As Object
Object GetExtender(
string ExtenderCATID,
string ExtenderName,
Object ExtendeeObject,
IExtenderSite ExtenderSite,
int Cookie
)
Object^ GetExtender(
[InAttribute] String^ ExtenderCATID,
[InAttribute] String^ ExtenderName,
[InAttribute] Object^ ExtendeeObject,
[InAttribute] IExtenderSite^ ExtenderSite,
[InAttribute] int Cookie
)
abstract GetExtender :
ExtenderCATID:string *
ExtenderName:string *
ExtendeeObject:Object *
ExtenderSite:IExtenderSite *
Cookie:int -> Object
function GetExtender(
ExtenderCATID : String,
ExtenderName : String,
ExtendeeObject : Object,
ExtenderSite : IExtenderSite,
Cookie : int
) : Object
パラメーター
- ExtenderCATID
型 : System.String
要求されているエクステンダーの CATID。
- ExtenderName
型 : System.String
要求されているエクステンダーの名前。
- ExtendeeObject
型 : System.Object
extendee オブジェクト。
- ExtenderSite
型 : EnvDTE.IExtenderSite
IExtenderSite インターフェイスが表すエクステンダーのサイト。
- Cookie
型 : System.Int32
エクステンダーを特定するクッキー。
戻り値
型 : System.Object
エクステンダー。
解説
GetExtender は、指定された Extendee のインスタンスに対して、特定の CATID と名前のエクステンダーを返します。このメソッドが呼び出されるのは、CanExtend が true を返す場合だけです。
拡張プロバイダーは、ExtenderSite オブジェクトと Cookie を保持する必要があります。
注意 |
---|
エクステンダー マネージャーは、エクステンダー オブジェクトの内部キャッシュを保持しているので、そのオブジェクトが破棄されるときに通知を受ける必要があります。エクステンダー オブジェクトを破棄したらすぐに NotifyDelete を呼び出す必要があります。アプリケーションがアイドル状態になるまで待たないでください。このメソッドを呼び出す前に、他の Visual Studio コンポーネントが破棄されたエクステンダー オブジェクトにアクセスしようとする可能性があります。このとき、Visual Studio がクラッシュする可能性があります。 |
[!メモ]
extendee オブジェクトは、IUnknown インターフェイスとして渡されます。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。