XmlEnumAttribute XmlEnumAttribute XmlEnumAttribute XmlEnumAttribute Class

Definizione

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento XmlSerializer.Controls how the XmlSerializer serializes an enumeration member.

public ref class XmlEnumAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field)]
public class XmlEnumAttribute : Attribute
type XmlEnumAttribute = class
    inherit Attribute
Public Class XmlEnumAttribute
Inherits Attribute
Ereditarietà
XmlEnumAttributeXmlEnumAttributeXmlEnumAttributeXmlEnumAttribute
Attributi

Esempi

L'esempio seguente applica il XmlEnumAttribute ai membri dell'enumerazione.The following example applies the XmlEnumAttribute to the members of an enumeration. Quando la XmlSerializer genera i dati XML per questa enumerazione, i dati sono conformi ai valori del Name proprietà.When the XmlSerializer generates XML data for this enumeration, the data conforms to the values of the Name properties.

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é la forma estesa XmlEnumAttribute.You can use the word XmlEnum in your code instead of the longer XmlEnumAttribute.

Commenti

Il XmlEnumAttribute appartiene a una famiglia di attributi che controlla come il XmlSerializer serializza o deserializza un oggetto.The XmlEnumAttribute belongs to a family of attributes that controls how the XmlSerializer serializes or deserializes an object. Per un elenco completo degli attributi simili, vedere gli attributi che controllano la serializzazione XML.For a complete list of similar attributes, see Attributes That Control XML Serialization.

Usare la XmlEnumAttribute per l'enumerazione delle modifiche che il XmlSerializer genera o riconosce (quando serializza o deserializza una classe, rispettivamente).Use the XmlEnumAttribute to change the enumeration that the XmlSerializer generates or recognizes (when it serializes or deserializes a class, respectively). Se, ad esempio, un'enumerazione contiene un membro denominato One, ma si preferisce che l'output XML denominate Single, si applicano le XmlEnumAttribute del membro di enumerazione e la Name proprietà su "Singola".For example, if an enumeration contains a member named One, but you prefer that the XML output be named Single, apply the XmlEnumAttribute to the enumeration member and set the Name property to "Single".

È possibile eseguire l'override di Name valore della proprietà di un XmlEnumAttribute mediante la creazione di un'istanza del XmlEnumAttribute classe e assegnarlo al XmlEnum proprietà di un XmlAttributes oggetto.You can override the Name property value of an XmlEnumAttribute by creating an instance of the XmlEnumAttribute class and assigning it to the XmlEnum property of an XmlAttributes object. Per informazioni dettagliate, vedere il XmlAttributeOverrides classe.For details, see the XmlAttributeOverrides class.

Nota

È possibile usare la parola XmlEnum nel codice anziché la forma estesa XmlEnumAttribute.You can use the word XmlEnum in your code instead of the longer XmlEnumAttribute.

Costruttori

XmlEnumAttribute() XmlEnumAttribute() XmlEnumAttribute() XmlEnumAttribute()

Inizializza una nuova istanza della classe XmlEnumAttribute.Initializes a new instance of the XmlEnumAttribute class.

XmlEnumAttribute(String) XmlEnumAttribute(String) XmlEnumAttribute(String) 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).Initializes a new instance of the XmlEnumAttribute class, and specifies the XML value that the XmlSerializer generates or recognizes (when it serializes or deserializes the enumeration, respectively).

Proprietà

Name Name Name 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.Gets or sets the value generated in an XML-document instance when the XmlSerializer serializes an enumeration, or the value recognized when it deserializes the enumeration member.

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a

Vedi anche