Attributi per il controllo della serializzazione XML

  • Articolo

È 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 comprendere in che modo gli 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 altre informazioni sull'applicazione di questi attributi a un metodo dei servizi Web XML, vedere Serializzazione XML mediante servizi Web XML.

Per altre informazioni sugli attributi, vedere Attributi.

Attributo Si applica a Dettagli
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.
ObsoleteAttribute Proprietà e campi pubblici La proprietà o il campo verranno ignorati quando la classe contenitore viene serializzata.

Oltre a questi attributi, tutti reperibili nello spazio dei nomi System.Xml.Serialization, a un campo può essere anche applicato l'attributo DefaultValueAttribute. 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.

Vedi anche