XmlEnumAttribute Klasse

Referenz

Definition

Namespace:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Steuert die Art, in der XmlSerializer einen Enumerationsmember 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 die XmlEnumAttribute Elemente einer Aufzählung angewendet. Wenn die XmlSerializer XML-Daten für diese Enumeration generiert werden, entspricht die Daten den Werten der Name Eigenschaften.

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

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

Die XmlEnumAttribute gehört zu einer Familie von Attributen, die steuert, wie die XmlSerializer Serialisierung oder Deserialisierung eines Objekts gesteuert wird. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute, die XML-Serialisierung steuern.

Ändern Sie die XmlEnumAttribute Aufzählung, die die XmlSerializer generiert oder erkennt (wenn sie eine Klasse serialisiert oder enterialisiert). Wenn z. B. eine Aufzählung ein Element enthält, aber Sie bevorzugen, dass die XML-Ausgabe benannt One``Singlewerden soll, wenden XmlEnumAttribute Sie das 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

XmlEnumAttribute()	Initialisiert eine neue Instanz der XmlEnumAttribute-Klasse.
XmlEnumAttribute(String)	Initialisiert eine neue Instanz der XmlEnumAttribute-Klasse, und gibt den XML-Wert an, der von XmlSerializer beim Serialisieren der Enumeration generiert bzw. beim Deserialisieren erkannt wird.

Eigenschaften

Name	Ruft den Wert ab, der bei der Serialisierung einer Enumeration durch XmlSerializer in einer XML-Dokumentinstanz generiert wurde bzw. bei der Deserialisierung eines Enumerationsmembers erkannt wurde, oder legt diesen fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_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 deren Hilfe 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)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für

Freigeben über