Attributi per il controllo della serializzazione XMLAttributes That Control XML Serialization

È 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.You can apply the attributes in the following table to classes and class members to control the way in which the XmlSerializer serializes or deserializes an instance of the class. Per comprendere in che modo gli attributi controllano la serializzazione XML, vedere Controllo della serializzazione XML mediante attributi.To understand how these attributes control XML serialization, see Controlling XML Serialization Using Attributes.

Tali attributi possono inoltre essere utilizzati per controllare i messaggi SOAP in stile letterale generati da qualsiasi servizio Web XML.These attributes can also be used to control the literal style SOAP messages generated by an XML Web service. Per altre informazioni sull'applicazione di questi attributi a un metodo dei servizi Web XML, vedere Serializzazione XML mediante servizi Web XML.For more information about applying these attributes to an XML Web services method, see XML Serialization with XML Web Services.

Per altre informazioni sugli attributi, vedere Attributi.For more information about attributes, see Attributes.

AttributoAttribute Si applica aApplies to SpecificaSpecifies
XmlAnyAttributeAttribute Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti XmlAttribute.Public field, property, parameter, or return value that returns an array of XmlAttribute objects. Durante la deserializzazione, la matrice verrà riempita con oggetti XmlAttribute che rappresentano tutti gli attributi XML ignoti allo schema.When deserializing, the array will be filled with XmlAttribute objects that represent all XML attributes unknown to the schema.
XmlAnyElementAttribute Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti XmlElement.Public field, property, parameter, or return value that returns an array of XmlElement objects. Durante la deserializzazione, la matrice viene riempita con oggetti XmlElement che rappresentano tutti gli elementi XML ignoti allo schema.When deserializing, the array is filled with XmlElement objects that represent all XML elements unknown to the schema.
XmlArrayAttribute Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti complessi.Public field, property, parameter, or return value that returns an array of complex objects. I membri della matrice verranno generati come membri di una matrice XML.The members of the array will be generated as members of an XML array.
XmlArrayItemAttribute Campo pubblico, proprietà, parametro o valore restituito che restituiscono una matrice di oggetti complessi.Public field, property, parameter, or return value that returns an array of complex objects. I tipi derivati che possono essere inseriti in una matrice.The derived types that can be inserted into an array. Applicati di solito congiuntamente a un XmlArrayAttribute.Usually applied in conjunction with an XmlArrayAttribute.
XmlAttributeAttribute Campo pubblico, proprietà, parametro o valore restituito.Public field, property, parameter, or return value. Il membro sarà serializzato come attributo XML.The member will be serialized as an XML attribute.
XmlChoiceIdentifierAttribute Campo pubblico, proprietà, parametro o valore restituito.Public field, property, parameter, or return value. È possibile risolvere ulteriormente l'ambiguità del membro tramite l'utilizzo di un'enumerazione.The member can be further disambiguated by using an enumeration.
XmlElementAttribute Campo pubblico, proprietà, parametro o valore restituito.Public field, property, parameter, or return value. Il campo o la proprietà verranno serializzati come elemento XML.The field or property will be serialized as an XML element.
XmlEnumAttribute Campo pubblico che rappresenta un identificatore dell'enumerazione.Public field that is an enumeration identifier. Il nome dell'elemento di un membro dell'enumerazione.The element name of an enumeration member.
XmlIgnoreAttribute Proprietà e campi pubbliciPublic properties and fields. La proprietà o il campo devono essere ignorati se la classe che li contiene è serializzata.The property or field should be ignored when the containing class is serialized.
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).Public derived class declarations, and return values of public methods for Web Services Description Language (WSDL) documents. La classe deve essere inclusa durante la generazione degli schemi (per essere riconosciuta se serializzata).The class should be included when generating schemas (to be recognized when serialized).
XmlRootAttribute Dichiarazioni di classe pubblicaPublic class declarations. Controlla la serializzazione XML della destinazione dell'attributo come un elemento radice XML.Controls XML serialization of the attribute target as an XML root element. Utilizzare l'attributo per specificare ulteriormente lo spazio dei nomi e il nome dell'elemento.Use the attribute to further specify the namespace and element name.
XmlTextAttribute Proprietà e campi pubbliciPublic properties and fields. La proprietà o il campo devono essere serializzati come testo XML.The property or field should be serialized as XML text.
XmlTypeAttribute Dichiarazioni di classe pubblicaPublic class declarations. Nome e spazio dei nomi del tipo XML.The name and namespace of the XML type.

Oltre a questi attributi, tutti reperibili nello spazio dei nomi System.Xml.Serialization, a un campo può essere anche applicato l'attributo DefaultValueAttribute.In addition to these attributes, which are all found in the System.Xml.Serialization namespace, you can also apply the DefaultValueAttribute attribute to a field. DefaultValueAttribute imposta il valore che verrà automaticamente assegnato al membro se non viene specificato alcun valore.The DefaultValueAttribute sets the value that will be automatically assigned to the member if no value is specified.

Per controllare la serializzazione XML con codifica SOAP, vedere Attributi che controllano la serializzazione con codifica SOAP.To control encoded SOAP XML serialization, see Attributes That Control Encoded SOAP Serialization.

Vedere ancheSee also