CodeAttribute2.Value – vlastnost

Článek
05/16/2015

Nastaví nebo získá data pro kód atributu.

Obor názvů: EnvDTE80
Sestavení: EnvDTE80 (v EnvDTE80.dll)

Syntaxe

'Deklarace
Property Value As String

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)

Hodnota vlastnosti

Typ: String
Řetězcovou hodnotu představující data pro kód atributu.

Poznámky

Pokud je atribut ve formě name(someval, 2), pak je hodnota someval, 2.

[!POZNÁMKA]

Hodnoty argumentu atributu kód, po přiřazení, nejsou zachovány v paměti tak, že Visual Studioa tedy může nebo nemusí být platný, dojde-li k budoucí aktualizaci argument atributu kód.To znamená další argument access může vrátit E_FAIL nebo zcela jinou hodnotu. (Vše, co ovlivňuje děti prvku však nemá problém.)

Z důvodu tohoto chování není deterministický by načíst tento argument hodnota před změnou jeho.Pokud nastavíte argument atributu typu kódu ve vašem kódu, jako například myAttrArg.Value = """a first value""", pak byste měli explicitně odkazovat před aktualizací, jako jsou například myAttrArg = myAttr.Arguments.Item("first value")a pak přiřadit novou hodnotu myAttrArg.Value = """a second value""".To zajišťuje, že správný argument se změní.

Hodnoty prvků modelu kód jako třídy, struktury, funkce, atributy, delegátů a tak dále může být nedeterministické po provedení určité typy úprav, což znamená, že jejich hodnoty nelze dovolávat vždy zůstat stejné.Další informace naleznete v části Změna hodnoty prvků modelu kód Zjišťování kódu pomocí modelu kódu (Visual Basic).

Příklady

Následující příklad vytvoří nový obor názvů a atribut v aktuální třídy a jsou uvedeny některé vlastnosti atributu.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.