CodeAttribute2.InfoLocation 屬性

發行項
10/28/2012

取得程式碼模型。

命名空間： EnvDTE80
組件： EnvDTE80 (在 EnvDTE80.dll 中)

語法

'宣告
ReadOnly Property InfoLocation As vsCMInfoLocation

vsCMInfoLocation InfoLocation { get; }

property vsCMInfoLocation InfoLocation {
    vsCMInfoLocation get ();
}

abstract InfoLocation : vsCMInfoLocation

function get InfoLocation () : vsCMInfoLocation

屬性值

型別：EnvDTE.vsCMInfoLocation
vsCMInfoLocation 常數值。

備註

如果 InfoLocation 屬性傳回 vsCMInfoLocationProject，則可設定屬性、取得 StartPoint 和取得 EndPoint 等。當您從某個程式碼模型物件 (A) 移至另一個 (B) 的時候，例如從某個函式移至它的型別，或從某個類別移至它的基底類別，如果 B 的定義位於其他專案中，則它可能會是 vsCMInfoLocationExternal 型別。實際情況要視該程式碼模型實作 (實作物件 B 專案的程式語言是否與實作物件 A 者相同) 而定。

如果 InfoLocation 屬性傳回 vsCMInfoLocationExternal，則資訊只能從 DLL 裡的中繼資料，或從凍結的原始程式取得。您或許可以取得 StartPoint 和 EditPoint，但是卻無法編輯文件。換言之，您無法設定屬性或修改程式碼項目後的文字。

如果 InfoLocation 傳回 vsCMInfoLocationNone，則所有可用的資訊都是具名的程式碼模型物件。而且，依原始程式碼的內容，在某些狀況下您可以分辨出該名稱應該是類別或是介面。不過，在這種情況下，由於程式碼模型無法將該名稱解析為任何真正的資訊，因此該物件可說是沒有什麼用處。

注意事項
在特定類型的編輯之後，程式碼模型項目 (例如類別、結構、函式、屬性、委派等) 的值可能不具決定性，表示其值不一定維持相同。如需詳細資訊，請參閱使用程式碼模型探索程式碼 (Visual Basic) 的＜程式碼模型項目值可以變更＞一節。

範例

下列範例會在目前的類別中建立新的命名空間和屬性，並列出屬性 (Attribute) 的部分屬性 (Property)。

public void CreateClassAndAttrib(DTE2 applicationObject)
{
    // Before running, load or create a project.
    FileCodeModel2 fcm2 = GetFileCodeModel(applicationObject);
    CodeAttribute2 cmAttribute;
    CodeClass2 cmClass;
    String msg = null;

    if (fcm2 != null)
    {
        CodeNamespace cmNamespace;
        // Try to create a new namespace.
        try
        {
            cmNamespace = fcm2.AddNamespace("CMNamespace", -1);
            // If successful, create the other code elements.
            if (cmNamespace != null)
            {
                cmClass = (CodeClass2)cmNamespace.AddClass("ANewClass", 
                -1, null, null, vsCMAccess.vsCMAccessPrivate);
                cmAttribute = (CodeAttribute2)cmClass.AddAttribute
                ("NewAttribute", "AttributeValue", -1);
                msg += "InfoLocation: " + cmAttribute.InfoLocation + 
                Environment.NewLine;
                msg += "IsCodeType?: " + cmAttribute.IsCodeType + 
                Environment.NewLine;
                msg += "Kind: " + cmAttribute.Kind + 
                Environment.NewLine;
                MessageBox.Show(msg);                       
            }
            else
            {
                MessageBox.Show("Cannot continue - no filecodemodel 
                available.");
            }
        }
        catch (Exception ex)
        {
            MessageBox.Show("ERROR: " + ex);
        }
    }
}

public FileCodeModel2 GetFileCodeModel(DTE2 applicationObject)
{
    // Returns the FileCodeModel object of the active 
    // window.
    TextWindow txtWin = 
    (TextWindow)applicationObject.ActiveWindow.Object;
    FileCodeModel2 fcm2;
    if (txtWin != null)
    {
        try
        {
             fcm2 = (FileCodeModel2)txtWin.Parent.
             ProjectItem.FileCodeModel;
             return fcm2;
        }
        catch (Exception ex)
        {
             MessageBox.Show("ERROR: " + ex);
             return null;
        }
    }
    else
        return null;
}