Propriedade CodeAttribute2.Collection

Artigo
05/17/2015

Obtém uma coleção de objetos de CodeAttribute2 .

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

Sintaxe

'Declaração
ReadOnly Property Collection As CodeElements

CodeElements Collection { get; }

property CodeElements^ Collection {
    CodeElements^ get ();
}

abstract Collection : CodeElements with get

function get Collection () : CodeElements

Valor de propriedade

Tipo: CodeElements
Uma coleção de objetos CodeAttribute2.

Comentários

Dica

Codificar valores de argumento de atributo, depois de ser atribuído, não são mantidos na memória por Visual Studioe, portanto, pode ou não ser válida quando uma atualização futura do argumento do atributo de código ocorre.Isto é, um acesso subsequente do argumento pode retornar E_FAIL ou um valor completamente diferente. (Qualquer coisa que afeta os filhos do elemento, porém, não tem este problema.)

Devido a esse comportamento não determinístico, você deve recuperar o valor do argumento antes de alterar isto.Por exemplo, se você definir um argumento de atributo de código no seu código, como myAttrArg.Value = """a first value""", ao referenciar explicitamente antes de atualizar, como myAttrArg = myAttr.Arguments.Item("first value"), atributos e o novo valor, myAttrArg.Value = """a second value""".Isso assegurará que o argumento correto foi alterado.

Além disso, os valores de código de modelagem elementos como classes, estruturas, funções, atributos, representantes, e assim por diante podem ser não determinísticas depois de fazer determinados tipos as edições do, o que significa que seus valores não podem ser confiáveis em para permanecer sempre os mesmos.Para obter mais informações, veja que os valores do elemento do modelo de código da seção podem ser alteradas em Descobrindo código usando o modelo de código (Visual Basic).

Exemplos

O exemplo a seguir cria uma nova namespace e atributo na classe atual e lista algumas das propriedades do atributo.

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

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