Поделиться через

XmlEnumAttribute Класс

Определение

Пространство имен:
System.Xml.Serialization
Сборки:
System.Xml.dll, System.Xml.XmlSerializer.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XmlSerializer.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlEnumAttribute.cs
Исходный код:
XmlEnumAttribute.cs
Исходный код:
XmlEnumAttribute.cs
Исходный код:
XmlEnumAttribute.cs
Исходный код:
XmlEnumAttribute.cs

Определяет, как 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 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, примените его к члену перечисления и присвойте XmlEnumAttributeName свойству значение Single.

Можно переопределить Name значение свойства, XmlEnumAttribute создав экземпляр XmlEnumAttribute класса и назначив его XmlEnum свойству XmlAttributes объекта. Дополнительные сведения см. в XmlAttributeOverrides классе.

Замечание

Вы можете использовать слово XmlEnum в коде вместо более длинного XmlEnumAttribute.

Конструкторы

Имя Описание
XmlEnumAttribute()

Инициализирует новый экземпляр класса XmlEnumAttribute.
XmlEnumAttribute(String)

Инициализирует новый экземпляр XmlEnumAttribute класса и задает XML-значение, которое XmlSerializer создает или распознает (при сериализации или десериализации перечисления соответственно).

Свойства

Имя Описание
Name

Возвращает или задает значение, созданное в экземпляре XML-документа при XmlSerializer сериализации перечисления, или значение, распознаваемое при десериализации элемента перечисления.
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)

Применяется к

См. также раздел