Propriedade CodeAttribute2.Arguments

Artigo
08/01/2011

Obtém uma coleção de CodeElement objetos que contém o CodeAttributeArgument objetos associados com esse atributo.

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

Sintaxe

'Declaração
ReadOnly Property Arguments As CodeElements
    Get

CodeElements Arguments { get; }

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

abstract Arguments : CodeElements

function get Arguments () : CodeElements

Valor de propriedade

Tipo: EnvDTE.CodeElements
Uma coleção de objetos CodeElement.

Comentários

Esta é uma nova propriedade para Visual Studio 2005.

Observação
Valores de argumento de atributo de código, após serem atribuídas, não são mantidos na memória por Visual Studio, assim, pode ou não ser válida quando ocorre uma futura atualização para o argumento de atributo de código. Ou seja, o acesso de um argumento subseqüente pode retornar E_FAIL ou um valor totalmente diferente. (Qualquer coisa que afete os filhos do elemento, no entanto, não tem esse problema.) Devido esse comportamento não-determinístico, você deve recuperar o valor do argumento antes de alterá-la. Por exemplo, se você definir um argumento de atributo de código no seu código, como myAttrArg.Value = """a first value""", em seguida, você deve referenciá-la antes de atualizá-lo, como explicitamente myAttrArg = myAttr.Arguments.Item("first value")e atribua o novo valor, myAttrArg.Value = """a second value""". Isso garante que o argumento correto é alterado. Além disso, 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).

Valores de argumento de atributo de código, após serem atribuídas, não são mantidos na memória por Visual Studio, assim, pode ou não ser válida quando ocorre uma futura atualização para o argumento de atributo de código. Ou seja, o acesso de um argumento subseqüente pode retornar E_FAIL ou um valor totalmente diferente. (Qualquer coisa que afete os filhos do elemento, no entanto, não tem esse problema.)

Devido esse comportamento não-determinístico, você deve recuperar o valor do argumento antes de alterá-la. Por exemplo, se você definir um argumento de atributo de código no seu código, como myAttrArg.Value = """a first value""", em seguida, você deve referenciá-la antes de atualizá-lo, como explicitamente myAttrArg = myAttr.Arguments.Item("first value")e atribua o novo valor, myAttrArg.Value = """a second value""". Isso garante que o argumento correto é alterado.

Além disso, 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

// The following example creates a new namespace and attribute in
// the current class and lists some of the attribute's properties.
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 += "Arguments: " + cmAttribute.Arguments + 
                Environment.NewLine;
                msg += "Count: " + cmAttribute.Children.Count + 
                Environment.NewLine;
                msg += "Endpoint Location: " + 
                cmAttribute.EndPoint.DisplayColumn + 
                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;
}

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.