CodeEvent.InfoLocation プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

コードモデルの機能を取得します。

名前空間 : EnvDTE80
アセンブリ : EnvDTE80 (EnvDTE80.dll 内)

構文

'宣言
ReadOnly Property InfoLocation As vsCMInfoLocation
'使用
Dim instance As CodeEvent
Dim value As vsCMInfoLocation

value = instance.InfoLocation

vsCMInfoLocation InfoLocation { get; }

property vsCMInfoLocation InfoLocation {
    vsCMInfoLocation get ();
}

function get InfoLocation () : vsCMInfoLocation

プロパティ値

型 : EnvDTE.vsCMInfoLocation

vsCMInfoLocation 値の 1 つ。

解説

InfoLocation が vsCMInfoLocationProject を返す場合、プロパティの設定、StartPoint の取得、EndPoint の取得などを実行できます。あるコードモデルオブジェクト (A) から他のコードモデルオブジェクト (B) に移動した場合 (関数からその型に移動する場合やクラスからその基本クラスに移動する場合など)、B の定義が他のプロジェクトにあると、B の型が vsCMInfoLocationExternal になる場合があります。これは、オブジェクト B のプロジェクトがオブジェクト A のプロジェクトと同じ言語で実装されているかどうかなど、コードモデルの実装によって決まります。

InfoLocation が vsCMInfoLocationExternal を返す場合、使用できる情報は、メタデータ、DLL、または固定されたソースの情報だけです。StartPoint および EditPoint を取得できても、ドキュメントは編集できません。つまり、プロパティを設定したり、コード要素の背後にあるテキストを変更したりできません。

InfoLocation が vsCMInfoLocationNone を返す場合、使用できるのは名前を持つコードモデルオブジェクトだけです。また、ソースコードのコンテキストに基づいて、名前がクラスとインターフェイスのどちらであるかを区別できる場合もあります。ただし、区別できない場合にはそのオブジェクトは役に立ちません。これは、コードモデルは名前を使用できる情報に解決できないためです。

メモ :
特定の種類の編集を行うと、クラス、構造体、関数、属性、デリゲートなどのコードモデル要素が非確定的な値になる場合があります。つまり、これらの要素の値は、常に同じ値になるとは限りません。詳細については、「コードモデルを使用したコードの調査 (Visual Basic)」の「変更されるコードモデル要素値」を参照してください。

特定の種類の編集を行うと、クラス、構造体、関数、属性、デリゲートなどのコードモデル要素が非確定的な値になる場合があります。つまり、これらの要素の値は、常に同じ値になるとは限りません。詳細については、「コードモデルを使用したコードの調査 (Visual Basic)」の「変更されるコードモデル要素値」を参照してください。

例

InfoLocation プロパティの使用方法を次の例に示します。

このプロパティをテストするには

ターゲットプロジェクトを開き、イベントオブジェクト上にカーソルを配置してコードイベント要素を選択します。
アドインを実行します。

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");
}