Condividi tramite


Attributi che controllano la serializzazione XML

È possibile applicare gli attributi nella seguente tabella a classi e membri di classe per controllare il modo in cui XmlSerializer serializza o deserializza un'istanza della classe. Per comprendere in che modo gli attributi controllano la serializzazione XML, vedere Controllo della serializzazione XML mediante attributi.

Tali attributi possono essere utilizzati anche 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 dei servizi Web XML, vedere Serializzazione XML con servizi Web XML.

Per ulteriori informazioni sugli attributi, vedere Estensione dei metadati mediante attributi.

Attributo Si applica a Specifica
XmlAnyAttributeAttribute Campo pubblico, proprietà, parametro o valore restituito che restituisce una matrice degli oggetti XmlAttribute. Durante la deserializzazione, nella matrice verranno inseriti gli oggetti XmlAttribute che rappresentano tutti gli attributi XML sconosciuti allo schema.
XmlAnyElementAttribute Campo pubblico, proprietà, parametro o valore restituito che restituisce una matrice degli oggetti XmlElement. Durante la deserializzazione, nella matrice verranno inseriti gli oggetti XmlElement che rappresentano tutti gli elementi XML sconosciuti allo schema.
XmlArrayAttribute Campo pubblico, proprietà, parametro o valore restituito che restituisce 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 restituisce una matrice di oggetti complessi. I tipi derivati che possono essere inseriti in una matrice. Generalmente applicato in combinazione con XmlArrayAttribute.
XmlAttributeAttribute Campo pubblico, proprietà, parametro o valore restituito. Il membro verrà serializzato come attributo XML.
XmlChoiceIdentifierAttribute Campo pubblico, proprietà, parametro o valore restituito. Del membro può essere ulteriormente risolta l'ambiguità utilizzando un'enumerazione.
XmlElementAttribute Campo pubblico, proprietà, parametro o valore restituito. La classe o la proprietà verrà serializzata come elemento XML.
XmlEnumAttribute Campo pubblico che rappresenta un identificatore dell'enumerazione. Il nome dell'elemento di un membro di enumerazione.
XmlIgnoreAttribute Proprietà e campi pubblici. La proprietà o il campo deve essere ignorato quando la classe che lo contiene viene serializzata.
XmlIncludeAttribute Dichiarazioni di una classe derivata pubblica e metodi pubblici (per documenti WSDL). La classe deve essere inclusa durante la generazione degli schemi, per essere riconosciuta quando è serializzata.
XmlRootAttribute Dichiarazioni delle classi pubbliche. Consente di controllare la serializzazione XML della destinazione dell'attributo come elemento principale XML. Utilizzare l'attributo per specificare meglio lo spazio dei nomi e il nome dell'elemento.
XmlTextAttribute Proprietà e campi pubblici. La proprietà o il campo deve essere serializzato come testo XML.
XmlTypeAttribute Dichiarazioni delle classi pubbliche. Il nome e lo spazio dei nomi del tipo XML.

Oltre a questi attributi, trovati nello spazio dei nomi System.Xml.Serialization, è possibile anche applicare l'attributo System.ComponentModel.DefaultValueAttribute a un campo. DefaultValueAttribute imposta il valore che verrà automaticamente assegnato al membro se non viene specificato alcun valore.

Per controllare la serializzazione XML con codifica SOAP, vedere Attributi che controllano la serializzazione con codifica SOAP.

Vedere anche

Serializzazione XML e SOAP | XmlSerializer | Controllo della serializzazione XML mediante attributi | Override della serializzazione XML