CodeAttributeArgument-Klasse

Stellt ein Argument dar, das in einer Deklaration eines Metadatenattributs verwendet wird.

Namespace: System.CodeDom
Assembly: System (in system.dll)

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class CodeAttributeArgument
'Usage
Dim instance As CodeAttributeArgument

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class CodeAttributeArgument

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class CodeAttributeArgument

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class CodeAttributeArgument

SerializableAttribute 
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class CodeAttributeArgument

Hinweise

CodeAttributeArgument kann verwendet werden, um den Wert für ein einzelnes Argument eines Attributkonstruktors oder einen Wert darzustellen, mit dem eine Eigenschaft des Attributs initialisiert wird.

Die Value-Eigenschaft gibt den Wert des Arguments an. Die Name-Eigenschaft gibt, sofern verwendet, den Namen einer Eigenschaft des Attributs an, dem der Wert zugewiesen werden soll.

Attributdeklarationen werden häufig mit einer Anzahl von Argumenten initialisiert, die zur Laufzeit an den Konstruktor des Attributs übergeben werden. Fügen Sie der Arguments-Auflistung einer CodeAttributeDeclaration für jedes Argument ein CodeAttributeArgument hinzu, um für den Konstruktor eines Attributs Argumente bereitzustellen. Es muss lediglich die Value-Eigenschaft jedes CodeAttributeArgument initialisiert werden. Die Reihenfolge der Argumente in der Auflistung muss der Reihenfolge der Argumente in der Methodensignatur des Konstruktors für das Attribut entsprechen.

Sie können auch Eigenschaften des Attributs festlegen, die nicht über den Konstruktor verfügbar sind, indem Sie ein CodeAttributeArgument bereitstellen, das den Namen der festzulegenden Eigenschaft und den festzulegenden Wert angibt.

Beispiel

Im folgenden Code wird eine Klasse erstellt, und es werden Codeattribute hinzugefügt, um die Klasse als serialisierbar und veraltet zu deklarieren.

    // Declare a new type called Class1.
    CodeTypeDeclaration class1 = new CodeTypeDeclaration("Class1");

    // Use attributes to mark the class as serializable and obsolete.
    CodeAttributeDeclaration codeAttrDecl = new CodeAttributeDeclaration(
                                                "System.Serializable");
    class1.CustomAttributes.Add(codeAttrDecl);

    CodeAttributeArgument codeAttr = new CodeAttributeArgument(
               new CodePrimitiveExpression("This class is obsolete."));
    codeAttrDecl = new CodeAttributeDeclaration("System.Obsolete", 
                                                       codeAttr);
    class1.CustomAttributes.Add(codeAttrDecl);
// A C# code generator produces the following source code for the preceeding example code:
//    [System.Serializable()]
//    [System.Obsolete("This class is obsolete.")]
//    public class Class1 {
//    }

    ' Declare a new type called Class1.
    Dim class1 As New CodeTypeDeclaration("Class1")

    ' Use attributes to mark the class as serializable and obsolete.
    Dim codeAttrDecl As New CodeAttributeDeclaration("System.Serializable")
    class1.CustomAttributes.Add(codeAttrDecl)

    Dim codeAttr As New CodeAttributeArgument( _
                   new CodePrimitiveExpression("This class is obsolete."))
    codeAttrDecl = New CodeAttributeDeclaration("System.Obsolete", codeAttr)
    class1.CustomAttributes.Add(codeAttrDecl)

' A Visual Basic code generator produces the following source code for the preceeding example code:
'    <System.Serializable(),  _
'     System.Obsolete("This class is obsolete.")>  _
'    Public Class Class1
'    End Class

Vererbungshierarchie

System.Object
  System.CodeDom.CodeAttributeArgument

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

CodeAttributeArgument-Member
System.CodeDom-Namespace
CodeAttributeDeclaration
CodeAttributeArgumentCollection