Propriedade CodeAttribute2.Value

Artigo
08/01/2011

Define ou obtém os dados para o atributo de código.

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

Sintaxe

'Declaração
Property Value As String
    Get
    Set

string Value { get; set; }

property String^ Value {
    String^ get ();
    void set (String^ value);
}

abstract Value : string with get, set

function get Value () : String
function set Value (value : String)

Valor de propriedade

Tipo: System.String
Um valor de seqüência de caracteres que representa os dados para o atributo de código.

Implementações

CodeAttribute.Value

Comentários

Se um atributo está no formato name(someval, 2), em seguida, o valor é someval, 2.

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

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

Sub ValueExample(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project
    ' and place the insertion point inside a class definition.
    Try
        ' Retrieve the CodeClass at the insertion point.
        Dim sel As TextSelection = _
            CType(dte.ActiveDocument.Selection, TextSelection)
        Dim cls As CodeClass = CType(sel.ActivePoint.CodeElement( _
            vsCMElement.vsCMElementClass), CodeClass)

        ' Enumerate the CodeClass's attributes.
        Dim attrs As String = ""
        Dim attr As CodeAttribute
        For Each attr In cls.Attributes
            attrs &= attr.Name & "(" & attr.Value & ")" & vbCrLf
        Next

        MsgBox(cls.Name & " has the following attributes:" & _
            vbCrLf & vbCrLf & attrs)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void ValueExample(DTE2 dte)
{
    // Before running this example, open a code document from a project
    // and place the insertion point inside a class definition.
    try
    {
        // Retrieve the CodeClass at the insertion point.
        TextSelection sel = 
            (TextSelection)dte.ActiveDocument.Selection;
        CodeClass cls = (CodeClass)sel.ActivePoint.get_CodeElement(
            vsCMElement.vsCMElementClass);

        // Enumerate the CodeClass's attributes.
        string attrs = "";
        foreach (CodeAttribute attr in cls.Attributes)
        {
            attrs += attr.Name + "(" + attr.Value + ")" + 
                Environment.NewLine;
        }

        MessageBox.Show(cls.Name + " has the following attributes:" + 
            Environment.NewLine + Environment.NewLine + attrs);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

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.