CodeAttribute2.Collection Свойство

Определение

Получает коллекцию объектов CodeAttribute2.

public:
 property EnvDTE::CodeElements ^ Collection { EnvDTE::CodeElements ^ get(); };
[System.Runtime.InteropServices.DispId(2)]
public EnvDTE.CodeElements Collection { [System.Runtime.InteropServices.DispId(2)] [System.Runtime.InteropServices.TypeLibFunc(1024)] get; }
[<System.Runtime.InteropServices.DispId(2)>]
[<get: System.Runtime.InteropServices.DispId(2)>]
[<get: System.Runtime.InteropServices.TypeLibFunc(1024)>]
member this.Collection : EnvDTE.CodeElements
Public ReadOnly Property Collection As CodeElements

Значение свойства

CodeElements

Коллекция объектов CodeAttribute2.

Реализации

Атрибуты

Примеры

В следующем примере создается новое пространство имен и атрибут в текущем классе и выводятся некоторые свойства атрибута.

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 += "Attribute count: " +   
                cmAttribute.Collection.Count + Environment.NewLine;  
                msg += "Document name: " +   
                cmAttribute.DTE.ActiveDocument.Name;  
            }  
            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;  
}  

Комментарии

Примечание

Значения аргумента атрибута Code после назначения не сохраняются в памяти Visual Studio , и, таким образом, могут быть недопустимыми, если происходит будущее обновление аргумента атрибута Code. То есть следующий доступ к аргументу может возвращать E_FAIL или совершенно другое значение. (Однако все, что влияет на дочерние элементы элемента, не имеет этой проблемы.)

Из-за этого недетерминированного поведения необходимо получить значение аргумента перед его изменением. Например, если задать в коде аргумент атрибута Code, например myAttrArg.Value = """a first value""" , необходимо явно ссылаться на него перед обновлением, например myAttrArg = myAttr.Arguments.Item("first value") , и назначить новое значение myAttrArg.Value = """a second value""" . Это гарантирует, что будет изменен правильный аргумент.

Кроме того, значения элементов модели кода, такие как классы, структуры, функции, атрибуты, делегаты и т. д., могут быть недетерминированными после внесения определенных видов изменений. Это означает, что их значения не могут полагаться на то, что они всегда остаются неизменными. Дополнительные сведения см. в разделе значения элементов модели кода могут изменяться при обнаружении кода с помощью модели кода (Visual Basic).

Применяется к