IExtenderProvider.GetExtender-Methode

Artikel
10/24/2012

Ruft einen Extender für das jeweilige Objekt in der angegebenen Kategorie ab.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
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

Parameter

ExtenderCATID
Typ: System.String
Die CATID des angeforderten Extenders.

ExtenderName
Typ: System.String
Der Name des angeforderten Extenders.

ExtendeeObject
Typ: System.Object
Das Extendee-Objekt.

ExtenderSite
Typ: EnvDTE.IExtenderSite
Die Extenderwebsite, die durch eine IExtenderSite-Schnittstelle dargestellt wird.

Cookie
Typ: System.Int32
Ein Cookie zur Identifizierung des Extenders.

Rückgabewert

Typ: System.Object
Ein Extender.

Hinweise

GetExtender gibt den Extender für die jeweilige CATID und den Namen der angegebenen Extendee-Instanz zurück.Diese Methode wird nur aufgerufen, wenn CanExtend den Wert true zurückgibt.

Der Extenderanbieter muss das ExtenderSite-Objekt und Cookie speichern.

Vorsicht
Der Extender-Manager verwaltet einen internen Cache von Extenderobjekten und muss benachrichtigt werden, wenn sie zerstört werden.Sie müssen sofort nach dem Zerstören von Extenderobjekten NotifyDelete aufrufen.Sie dürfen nicht warten, bis sich die Anwendung im Leerlauf befindet, da möglicherweise andere Visual Studio-Komponenten versuchen, auf das zerstörte Extenderobjekt zuzugreifen, bevor Sie die Methode aufrufen.Wenn dies geschieht, stürzt Visual Studio möglicherweise ab.

Der Extender-Manager verwaltet einen internen Cache von Extenderobjekten und muss benachrichtigt werden, wenn sie zerstört werden.Sie müssen sofort nach dem Zerstören von Extenderobjekten NotifyDelete aufrufen.Sie dürfen nicht warten, bis sich die Anwendung im Leerlauf befindet, da möglicherweise andere Visual Studio-Komponenten versuchen, auf das zerstörte Extenderobjekt zuzugreifen, bevor Sie die Methode aufrufen.Wenn dies geschieht, stürzt Visual Studio möglicherweise ab.

.NET Framework-Sicherheit

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.