Attributi per il controllo della serializzazione XML

È possibile applicare gli attributi riportati nella seguente tabella alle classi e ai membri delle classi per controllare le modalità di serializzazione o deserializzazione di un'istanza della classe da parte di XmlSerializer. Per informazioni sul modo in cui tali attributi controllano la serializzazione XML, vedere Controllo della serializzazione XML mediante attributi.

Tali attributi possono inoltre essere utilizzati per controllare i messaggi SOAP in stile letterale generati da qualsiasi servizio Web XML. Per ulteriori informazioni sull'applicazione di questi attributi a un metodo di servizio Web XML, vedere Serializzazione XML con Servizi Web XML.

Per ulteriori informazioni sugli attributi, vedere Extending Metadata Using Attributes.

Attributo Si applica a Specifica

XmlAnyAttributeAttribute

Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti XmlAttribute.

Durante la deserializzazione, la matrice verrà riempita con oggetti XmlAttribute che rappresentano tutti gli attributi XML ignoti allo schema.

XmlAnyElementAttribute

Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti XmlElement.

Durante la deserializzazione, la matrice viene riempita con oggetti XmlElement che rappresentano tutti gli elementi XML ignoti allo schema.

XmlArrayAttribute

Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti complessi.

I membri della matrice verranno generati come membri di una matrice XML.

XmlArrayItemAttribute

Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti complessi.

I tipi derivati che possono essere inseriti in una matrice. Applicati di solito congiuntamente a un XmlArrayAttribute.

XmlAttributeAttribute

Campo pubblico, proprietà, parametro o valore restituito.

Il membro sarà serializzato come attributo XML.

XmlChoiceIdentifierAttribute

Campo pubblico, proprietà, parametro o valore restituito.

È possibile risolvere ulteriormente l'ambiguità del membro tramite l'utilizzo di un'enumerazione.

XmlElementAttribute

Campo pubblico, proprietà, parametro o valore restituito.

Il campo o la proprietà verranno serializzati come elemento XML.

XmlEnumAttribute

Campo pubblico che rappresenta un identificatore dell'enumerazione.

Il nome dell'elemento di un membro dell'enumerazione.

XmlIgnoreAttribute

Proprietà e campi pubblici

La proprietà o il campo devono essere ignorati se la classe che li contiene è serializzata.

XmlIncludeAttribute

Dichiarazioni della classe derivata pubblica e valori restituiti di metodi pubblici per i documenti del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language).

La classe deve essere inclusa durante la generazione degli schemi (per essere riconosciuta se serializzata).

XmlRootAttribute

Dichiarazioni di classe pubblica

Controlla la serializzazione XML della destinazione dell'attributo come un elemento radice XML. Utilizzare l'attributo per specificare ulteriormente lo spazio dei nomi e il nome dell'elemento.

XmlTextAttribute

Proprietà e campi pubblici

La proprietà o il campo devono essere serializzati come testo XML.

XmlTypeAttribute

Dichiarazioni di classe pubblica

Nome e spazio dei nomi del tipo XML.

Oltre a questi attributi, tutti reperibili nello spazio dei nomi System.Xml.Serialization, a un campo può essere anche applicato l'attributo System.ComponentModel.DefaultValueAttribute. DefaultValueAttribute imposta il valore che sarà assegnato automaticamente al membro nel caso non sia specificato alcun valore.

Per il controllo della serializzazione XML con codifica SOAP, vedere Attributi per il controllo della serializzazione SOAP codificata.

Vedere anche

Attività

Procedura: specificare un nome di elemento alternativo per un flusso XML
Procedura: serializzare un oggetto
Procedura: deserializzare un oggetto

Riferimento

XmlSerializer

Concetti

Controllo della serializzazione XML mediante attributi

Altre risorse

Serializzazione SOAP e XML