XmlEnumAttribute 类

  • 参考

定义

命名空间:
System.Xml.Serialization
程序集:
System.Xml.XmlSerializer.dll
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll

控制 XmlSerializer 如何序列化枚举成员。

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
继承
Object
Attribute
XmlEnumAttribute
属性
AttributeUsageAttribute

示例

以下示例将 XmlEnumAttribute 枚举的成员应用于该枚举。 XmlSerializer生成此枚举的 XML 数据时，数据符合属性的值Name。

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

备注

可以在代码中使用单词 XmlEnum ，而不是较长 XmlEnumAttribute时间。

注解

属于 XmlEnumAttribute 一系列属性，用于控制序列化或反序列化对象的方式 XmlSerializer 。 有关类似属性的完整列表，请参阅 控制 XML 序列化的属性。

XmlEnumAttribute用于更改生成或识别 (的枚举XmlSerializer时，它们分别序列化或反序列化类) 。 例如，如果枚举包含一 One个名为的成员，但你更喜欢将 XML 输出命名 Single，请将 XmlEnumAttribute 该属性应用于枚举成员，并将属性设置为 Name “Single”。

可以通过创建类的XmlEnumAttribute实例并将其分配给XmlEnum对象的属性来替代Name该XmlEnumAttribute对象的属性值XmlAttributes。 有关详细信息，请参阅该 XmlAttributeOverrides 类。

备注

可以在代码中使用单词 XmlEnum ，而不是较长 XmlEnumAttribute时间。

构造函数

XmlEnumAttribute()

初始化 XmlEnumAttribute 类的新实例。
XmlEnumAttribute(String)

初始化 XmlEnumAttribute 类的新实例，并指定 XmlSerializer 生成或识别的（当该序列化程序分别序列化或反序列化枚举时）XML 值。

属性

Name

获取或设置当 XmlSerializer 序列化枚举时在 XML 文档实例中生成的值，或当它反序列化该枚举成员时识别的值。
TypeId

在派生类中实现时，获取此 Attribute 的唯一标识符。

(继承自 Attribute)

方法

Equals(Object)

返回一个值，该值指示此实例是否与指定的对象相等。

(继承自 Attribute)
GetHashCode()

返回此实例的哈希代码。

(继承自 Attribute)
GetType()

获取当前实例的 Type。

(继承自 Object)
IsDefaultAttribute()

在派生类中重写时，指示此实例的值是否是派生类的默认值。

(继承自 Attribute)
Match(Object)

当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。

(继承自 Attribute)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

显式接口实现

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

将一组名称映射为对应的一组调度标识符。

(继承自 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

检索对象的类型信息，然后可以使用该信息获取接口的类型信息。

(继承自 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

检索对象提供的类型信息接口的数量（0 或 1）。

(继承自 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供对某一对象公开的属性和方法的访问。

(继承自 Attribute)

适用于

另请参阅