Método IExtenderProviderUnk.GetExtender

Artigo
05/17/2015

Retorna um extensor para o objeto fornecido na categoria especificada.

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

Sintaxe

'Declaração
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

Parâmetros

ExtenderCATID
Tipo: String

O CATID do extensor que está sendo solicitado.

ExtenderName
Tipo: String

O nome do extensor que está sendo solicitado.

ExtendeeObject
Tipo: Object

O objeto estendido.

ExtenderSite
Tipo: EnvDTE.IExtenderSite

O site do extensor, representado por um IExtenderSite interface.

Cookie
Tipo: Int32

O cookie, identificando o extensor.

Valor de retorno

Tipo: Object
Um extensor.

Comentários

GetExtenderRetorna o extensor para o CATID determinado e o nome para a instância especificada estendido. Este método é chamado somente se CanExtend retorna true.

O provedor do extensor deve manter ExtenderSite objeto e Cookie.

Aviso

O Gerenciador de extensor mantém um cache interno dos objetos do extender e deve ser notificado quando estão sendo destruídos.Você deve chamar NotifyDelete imediatamente após a destruição de objetos do extender.Você não deve esperar o aplicativo fique ocioso, porque outros componentes de Visual Studio podem tentar acessar o objeto extensor destruído antes de chamar o método.Se isso acontecer, o Visual Studio pode falhar.

Dica

O objeto estendido é passado como uma interface IUnknown.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.