XmlEnumAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento 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

Ereditarietà: Object

Attribute
XmlEnumAttribute

Attributi: AttributeUsageAttribute

Esempio

Nell'esempio seguente viene applicato l'oggetto XmlEnumAttribute ai membri di un'enumerazione. Quando genera XmlSerializer i dati XML per questa enumerazione, i dati sono conformi ai valori delle Name proprietà.

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

Nota

È possibile usare la parola XmlEnum nel codice anziché più lunga XmlEnumAttribute.

Commenti

Appartiene XmlEnumAttribute a una famiglia di attributi che controlla la modalità XmlSerializer di serializzazione o deserializza un oggetto. Per un elenco completo di attributi simili, vedere Attributi che controllano la serializzazione XML.

Utilizzare l'oggetto XmlEnumAttribute per modificare l'enumerazione che genera XmlSerializer o riconosce (quando serializza o deserializza rispettivamente una classe). Ad esempio, se un'enumerazione contiene un membro denominato One, ma si preferisce che l'output XML sia denominato Single, applicare l'oggetto XmlEnumAttribute al membro di enumerazione e impostare la Name proprietà su "Single".

È possibile eseguire l'override del Name valore della proprietà di un oggetto XmlEnumAttribute creando un'istanza XmlEnumAttribute della classe e assegnandola alla XmlEnum proprietà di un XmlAttributes oggetto. Per informazioni dettagliate, vedere la XmlAttributeOverrides classe .

Nota

È possibile usare la parola XmlEnum nel codice anziché più lunga XmlEnumAttribute.

Costruttori

XmlEnumAttribute()	Inizializza una nuova istanza della classe XmlEnumAttribute.
XmlEnumAttribute(String)	Inizializza una nuova istanza della classe XmlEnumAttribute e specifica il valore XML che XmlSerializer genera o riconosce (rispettivamente quando serializza o deserializza una classe).

Proprietà

Name	Ottiene o imposta il valore generato in un'istanza di un documento XML quando XmlSerializer serializza un'enumerazione o il valore riconosciuto quando deserializza il membro dell'enumerazione.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a