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 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.
