XmlEnumAttribute Classe

Definição

Espaço de Nomes:
System.Xml.Serialization
Assemblagens:
System.Xml.dll, System.Xml.XmlSerializer.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Controla como serializa XmlSerializer um membro de enumeração.

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
Herança
Object
Attribute
XmlEnumAttribute
Atributos
AttributeUsageAttribute

Exemplos

O exemplo seguinte aplica-se aos XmlEnumAttribute membros de uma enumeração. Quando gera XmlSerializer dados XML para esta enumeração, os dados cumprem os valores das Name propriedades.

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

Note

Podes usar a palavra XmlEnum no teu código em vez do mais longo XmlEnumAttribute.

Observações

Pertence XmlEnumAttribute a uma família de atributos que controla como serializa XmlSerializer ou desserializa um objeto. Para obter uma lista completa de atributos semelhantes, consulte Atributos que controlam a serialização XML.

Use o XmlEnumAttribute para alterar a enumeração que o XmlSerializer gera ou reconhece (quando serializa ou desserializa uma classe, respetivamente). Por exemplo, se uma enumeração contiver um membro chamado One, mas preferir que a saída XML seja nomeada Single, aplicar o XmlEnumAttribute ao membro da enumeração e definir a Name propriedade como "Single".

Pode sobrescrever o Name valor da propriedade de an XmlEnumAttribute criando uma instância da XmlEnumAttribute classe e atribuindo-a à XmlEnum propriedade de um XmlAttributes objeto. Para mais detalhes, consulte a XmlAttributeOverrides aula.

Note

Podes usar a palavra XmlEnum no teu código em vez do mais longo XmlEnumAttribute.

Construtores

Name Description
XmlEnumAttribute()

Inicializa uma nova instância da XmlEnumAttribute classe.
XmlEnumAttribute(String)

Inicializa uma nova instância da XmlEnumAttribute classe e especifica o valor XML que gera XmlSerializer ou reconhece (quando serializa ou desserializa a enumeração, respetivamente).

Propriedades

Name Description
Name

Obtém ou define o valor gerado numa instância de documento XML quando serializa XmlSerializer uma enumeração, ou o valor reconhecido quando desserializa o membro da enumeração.
TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)

Métodos

Name Description
Equals(Object)

Devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
GetHashCode()

Devolve o código de hash para esta instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

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

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a

Ver também