XmlEnumAttribute Třída

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlEnumAttribute.cs

Určuje, jak XmlSerializer serializuje člen výčtu.

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

Dědičnost

Object

Attribute

XmlEnumAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad se vztahuje na XmlEnumAttribute členy výčtu. Když vygeneruje XmlSerializer data XML pro tento výčet, data odpovídají hodnotám Name vlastností.

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

Poznámka:

Místo delšího XmlEnumAttributekódu můžete použít slovo XmlEnum v kódu .

Poznámky

Patří XmlEnumAttribute do řady atributů, které řídí, jak XmlSerializer serializuje nebo deserializuje objekt. Úplný seznam podobných atributů naleznete v části Atributy, které řídí serializaci XML.

XmlEnumAttribute Použijte ke změně výčtu, který XmlSerializer generuje nebo rozpozná (při serializaci nebo deserializuje třídu, v uvedeném pořadí). Pokud například výčet obsahuje člen pojmenovaný One, ale dáváte přednost tomu, že výstup XML má být pojmenován Single, použijte u XmlEnumAttribute člena výčtu a nastavte Name vlastnost na "Single".

Hodnotu vlastnosti objektu můžete přepsat Name tak, že vytvoříte instanci XmlEnumAttribute třídy a přiřadíte ji k XmlEnum vlastnosti objektuXmlAttributes.XmlEnumAttribute Podrobnosti najdete v XmlAttributeOverrides třídě.

Poznámka:

Místo delšího XmlEnumAttributekódu můžete použít slovo XmlEnum v kódu .

Konstruktory

Name	Description
XmlEnumAttribute()	Inicializuje novou instanci XmlEnumAttribute třídy.
XmlEnumAttribute(String)	Inicializuje novou instanci XmlEnumAttribute třídy a určuje hodnotu XML, která XmlSerializer generuje nebo rozpozná (při serializaci nebo deserializuje výčet, v uvedeném pořadí).

Vlastnosti

Name	Description
Name	Získá nebo nastaví hodnotu vygenerovanou v instanci XML-document při XmlSerializer serializaci výčtu nebo hodnota rozpoznaná při deserializuje člen výčtu.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Serialize(TextWriter, Object)
• Deserialize(Stream)
• XmlSerializer
• XmlEnum
• XmlAttributeOverrides
• XmlAttributes
• Představujeme serializaci XML
• Postupy: Určení alternativního názvu elementu pro datový proud XML
• Řízení serializace XML pomocí atributů
• Příklady serializace XML
• Nástroj XML Schema Definition (Xsd.exe)