Método IExtenderProvider.GetExtender

Artigo
10/26/2012

Obtém 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: System.String
O CATID do extensor que está sendo solicitado.

ExtenderName
Tipo: System.String
O nome do extensor que está sendo solicitado.

ExtendeeObject
Tipo: System.Object
O objeto estendido.

ExtenderSite
Tipo: EnvDTE.IExtenderSite
O site do extensor, representado por um IExtenderSite interface.

Cookie
Tipo: System.Int32
O cookie, identificando o extensor.

Valor de retorno

Tipo: System.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 a ExtenderSite objeto e Cookie.

Cuidado
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.

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.

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áveis.