Freigeben über

XmlEnumAttribute Klasse

Definition

Namespace:
System.Xml.Serialization
Assemblys:
System.Xml.dll, System.Xml.XmlSerializer.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlSerializer.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XmlEnumAttribute.cs
Quelle:
XmlEnumAttribute.cs
Quelle:
XmlEnumAttribute.cs
Quelle:
XmlEnumAttribute.cs
Quelle:
XmlEnumAttribute.cs

Steuert, wie das XmlSerializer ein Enumerationselement serialisiert.

public ref class XmlEnumAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field)]
public class XmlEnumAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Field)>]
type XmlEnumAttribute = class
    inherit Attribute
Public Class XmlEnumAttribute
Inherits Attribute
Vererbung
Object
Attribute
XmlEnumAttribute
Attribute
AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird dies XmlEnumAttribute auf die Member einer Enumeration angewendet. Wenn die XmlSerializer XML-Daten für diese Enumeration generiert werden, entsprechen die Daten den Werten der Name Eigenschaften.

public enum EmployeeStatus
{
   [XmlEnum(Name = "Single")]
   One,
   [XmlEnum(Name = "Double")]
   Two,
   [XmlEnum(Name = "Triple")]
   Three
}

Public Enum EmployeeStatus
   <XmlEnum("Single")> One = 1
   <XmlEnum("Double")> Two = 2
   <XmlEnum("Triple")> Three = 3
End Enum

Hinweis

Sie können das Wort XmlEnum in Ihrem Code anstelle der längeren XmlEnumAttributeVerwenden.

Hinweise

Dies XmlEnumAttribute gehört zu einer Familie von Attributen, die steuert, wie das XmlSerializer Serialisieren oder Deserialisieren eines Objekts. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attributes That Control XML Serialization.

Verwenden Sie die XmlEnumAttribute Zum Ändern der von der XmlSerializer Enumeration generierten oder erkannten Aufzählung (wenn sie eine Klasse serialisiert oder deserialisiert). Wenn z. B. eine Enumeration ein Element mit dem Namen Oneenthält, aber Sie bevorzugen, dass die XML-Ausgabe benannt Singlewird, wenden Sie das XmlEnumAttribute Aufzählungselement an, und legen Sie die Name Eigenschaft auf "Single" fest.

Sie können den Name Eigenschaftswert eines XmlEnumAttribute Objekts außer Kraft setzen, indem Sie eine Instanz der XmlEnumAttribute Klasse erstellen und sie der XmlEnum Eigenschaft eines XmlAttributes Objekts zuweisen. Ausführliche Informationen finden Sie in der XmlAttributeOverrides Klasse.

Hinweis

Sie können das Wort XmlEnum in Ihrem Code anstelle der längeren XmlEnumAttributeVerwenden.

Konstruktoren

Name Beschreibung
XmlEnumAttribute()

Initialisiert eine neue Instanz der XmlEnumAttribute-Klasse.
XmlEnumAttribute(String)

Initialisiert eine neue Instanz der XmlEnumAttribute Klasse und gibt den XML-Wert an, den der XmlSerializer generierte oder erkennt (wenn die Enumeration serialisiert oder deserialisiert wird).

Eigenschaften

Name Beschreibung
Name

Dient zum Abrufen oder Festlegen des Werts, der in einer XML-Dokumentinstanz generiert wird, wenn die XmlSerializer Serialisierung einer Enumeration oder der Wert, der beim Deserialisieren des Enumerationselements erkannt wird.
TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)

Methoden

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen