XmlEnumAttribute XmlEnumAttribute XmlEnumAttribute XmlEnumAttribute Class

Definition

Steuert die Art, in der XmlSerializer einen Enumerationsmember serialisiert.Controls how the XmlSerializer serializes an enumeration member.

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

Beispiele

Im folgenden Beispiel wird der XmlEnumAttribute auf die Member einer Enumeration angewendet.The following example applies the XmlEnumAttribute to the members of an enumeration. Wenn das XmlSerializer XML-Daten für diese Enumeration generiert, entsprechen die Daten den Werten Name der Eigenschaften.When the XmlSerializer generates XML data for this enumeration, the data conforms to the values of the Name properties.

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.You can use the word XmlEnum in your code instead of the longer XmlEnumAttribute.

Hinweise

Der XmlEnumAttribute gehört zu einer Gruppe von Attributen, die steuert, XmlSerializer wie ein Objekt serialisiert oder deserialisiert.The XmlEnumAttribute belongs to a family of attributes that controls how the XmlSerializer serializes or deserializes an object. Eine umfassende Liste mit ähnlichen Attributen finden Sie unter Attribute, die die XML-Serialisierung steuern.For a complete list of similar attributes, see Attributes That Control XML Serialization.

Verwenden Sie XmlSerializer , um die Enumeration zu ändern, die von der generiert oder erkannt wird (beim Serialisieren bzw. Deserialisieren einer Klasse). XmlEnumAttributeUse the XmlEnumAttribute to change the enumeration that the XmlSerializer generates or recognizes (when it serializes or deserializes a class, respectively). Wenn eine Enumeration z. b. einen Member mit Onedem Namen enthält, Sie jedoch bevorzugen, dass die SingleXML-Ausgabe XmlEnumAttribute den Namen hat, wenden Sie das auf Name den Enumerationsmember an, und legen Sie die Eigenschaft auf "Single" fest.For example, if an enumeration contains a member named One, but you prefer that the XML output be named Single, apply the XmlEnumAttribute to the enumeration member and set the Name property to "Single".

Sie können Name den Eigenschafts Wert XmlAttributes XmlEnumAttribute eines überschreiben, indem Sie eine Instanz XmlEnumAttribute der-Klasse erstellen und Sie XmlEnum der-Eigenschaft eines Objekts zuweisen.You can override the Name property value of an XmlEnumAttribute by creating an instance of the XmlEnumAttribute class and assigning it to the XmlEnum property of an XmlAttributes object. Weitere Informationen finden Sie in XmlAttributeOverrides der-Klasse.For details, see the XmlAttributeOverrides class.

Hinweis

Sie können das Wort XmlEnum in Ihrem Code anstelle der längeren XmlEnumAttributeverwenden.You can use the word XmlEnum in your code instead of the longer XmlEnumAttribute.

Konstruktoren

XmlEnumAttribute() XmlEnumAttribute() XmlEnumAttribute() XmlEnumAttribute()

Initialisiert eine neue Instanz der XmlEnumAttribute-Klasse.Initializes a new instance of the XmlEnumAttribute class.

XmlEnumAttribute(String) XmlEnumAttribute(String) XmlEnumAttribute(String) 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.Initializes a new instance of the XmlEnumAttribute class, and specifies the XML value that the XmlSerializer generates or recognizes (when it serializes or deserializes the enumeration, respectively).

Eigenschaften

Name Name Name 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.Gets or sets the value generated in an XML-document instance when the XmlSerializer serializes an enumeration, or the value recognized when it deserializes the enumeration member.

TypeId TypeId TypeId TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Gilt für:

Siehe auch