Propriedade CodeEvent.InfoLocation

Artigo
08/01/2011

Obtém os recursos do modelo de código.

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

Sintaxe

'Declaração
ReadOnly Property InfoLocation As vsCMInfoLocation
    Get

vsCMInfoLocation InfoLocation { get; }

property vsCMInfoLocation InfoLocation {
    vsCMInfoLocation get ();
}

abstract InfoLocation : vsCMInfoLocation

function get InfoLocation () : vsCMInfoLocation

Valor de propriedade

Tipo: EnvDTE.vsCMInfoLocation
Dentre as vsCMInfoLocation valores.

Comentários

Se InfoLocation retorna vsCMInfoLocationProject, e em seguida, você pode definir propriedades, obter um StartPoint, obter um EndPointe assim por diante. Quando você entrar no objeto de modelo de código de um (A) para outro (B) — por exemplo, de uma função para seu tipo ou de uma classe para sua classe base — B pode ser do tipo vsCMInfoLocationExternal se a sua definição é em outro projeto. A disposição depende da implementação do modelo de código, o objeto se o projeto de b é implementado no mesmo idioma do objeto do e assim por diante.

Se InfoLocation retorna vsCMInfoLocationExternal, em seguida, as informações são disponíveis somente a partir de metadados, de uma DLL de inspeção ou de fontes congeladas. Você poderá obter um StartPoint e EditPoint, mas não é possível editar o documento; ou seja, você não pode definir propriedades ou modificar o texto atrás do elemento de código.

Se InfoLocation retorna vsCMInfoLocationNone, tudo o que está disponível é um objeto de modelo de código que tem um nome. Além disso, com base no contexto de código fonte, em alguns casos você pode dizer se o nome deve ser uma classe ou uma interface. Nessa situação, no entanto, porque o modelo de código não foi possível resolver o nome de qualquer informação útil, o objeto é contrário inútil.

Observação
Os valores dos elementos de modelo de código como classes, estruturas, funções, atributos, delegados e assim por diante podem ser não-determinísticos depois de fazer determinados tipos de edições, o que significa que seus valores não confie sempre permanecer o mesmo. Para obter mais informações, consulte a seção valores de elemento de modelo de código podem ser alteradas nas Descobrindo o Código usando o modelo de Código (Visual Basic).

Os valores dos elementos de modelo de código como classes, estruturas, funções, atributos, delegados e assim por diante podem ser não-determinísticos depois de fazer determinados tipos de edições, o que significa que seus valores não confie sempre permanecer o mesmo. Para obter mais informações, consulte a seção valores de elemento de modelo de código podem ser alteradas nas Descobrindo o Código usando o modelo de Código (Visual Basic).

Exemplos

O exemplo a seguir demonstra como usar o InfoLocation propriedade.

Para testar essa propriedade:

Abra o projeto de destino e selecione o elemento do código de evento, colocando o cursor sobre o objeto de evento.
Execute o add-in.

public static void InfoLocation(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    MessageBox.Show("\nInfoLocation property: " +
                    codeEvent.InfoLocation, "Testing CodeEvent");
}

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.