CodeAttribute2.Value Property

Reference

Definition

Namespace:: EnvDTE80

Assembly:: EnvDTE80.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.12.40391

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets or gets the data for the code attribute.

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

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

[System.Runtime.InteropServices.DispId(32)]
public string Value { [System.Runtime.InteropServices.DispId(32)] get; [System.Runtime.InteropServices.DispId(32)] set; }

[<System.Runtime.InteropServices.DispId(32)>]
[<get: System.Runtime.InteropServices.DispId(32)>]
[<set: System.Runtime.InteropServices.DispId(32)>]
member this.Value : string with get, set

Public Property Value As String

Property Value

String

A string value representing the data for the code attribute.

Implements

Value

Attributes: DispIdAttribute

Examples

The following example creates a new namespace and attribute in the current class and lists some of the attribute's properties.

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

Remarks

If an attribute is in the form name(someval, 2), then the value is someval, 2.

Note

Code attribute argument values, after being assigned, are not retained in memory by Visual Studio, and thus, may or may not be valid when a future update to the code attribute argument occurs. That is, a subsequent argument access may return E_FAIL or a totally different value. (Anything that affects the element's children, however, does not have this problem.)

Because of this non-deterministic behavior, you should retrieve the argument's value prior to changing it. For example, if you set a code attribute argument in your code, such as myAttrArg.Value = """a first value""", then you should explicitly reference it before updating it, such as myAttrArg = myAttr.Arguments.Item("first value"), and then assign the new value, myAttrArg.Value = """a second value""". Doing this ensures that the correct argument is changed.

Also, the values of code model elements such as classes, structs, functions, attributes, delegates, and so forth can be non-deterministic after making certain kinds of edits, meaning that their values cannot be relied upon to always remain the same. For more information, see the section Code Model Element Values Can Change in Discovering Code by Using the Code Model (Visual Basic).

Applies to

Partager via