System.Xml.Serialization Namespace

Lo spazio dei nomi System.Xml.Serialization contiene classi utilizzate per serializzare oggetti in documenti o flussi in formato XML. The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

Classi

CodeExporter

Rappresenta una classe in grado di generare codice proxy da una rappresentazione XML di una struttura di dati.Represents a class that can generate proxy code from an XML representation of a data structure.

CodeIdentifier

Fornisce un metodo statico per la conversione di testo di input in nomi per entità di codice.Provides static methods to convert input text into names for code entities.

CodeIdentifiers

Gestisce un gruppo di nomi di entità di codice o mapping di tipi correlati generati dall'infrastruttura di serializzazione XML di .NET Framework.Maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.

ImportContext

Descrive il contesto in cui un insieme di schemi viene associato a entità di codice .NET Framework.Describes the context in which a set of schema is bound to .NET Framework code entities.

SchemaImporter

Descrive un'utilità di importazione dello schema.Describes a schema importer.

SoapAttributeAttribute

Specifica che XmlSerializer deve serializzare il membro della classe come attributo SOAP codificato.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.

SoapAttributeOverrides

Consente di eseguire l'override di attributi applicati a proprietà, campi e classi in caso di utilizzo di un elemento XmlSerializer per la serializzazione o la deserializzazione di un oggetto con codifica SOAP.Allows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP.

SoapAttributes

Rappresenta una raccolta di oggetti attributo che controlla le modalità di serializzazione e deserializzazione di metodi SOAP mediante l'elemento XmlSerializer.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.

SoapCodeExporter

Genera tipi e dichiarazioni di attributo da informazioni di mapping dei tipi interno per parti di messaggi con codifica SOAP definite in un documento WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.

SoapElementAttribute

Consente di specificare che il valore del membro pubblico venga serializzato dalla classe XmlSerializer come elemento XML SOAP codificato.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.

SoapEnumAttribute

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento XmlSerializer.Controls how the XmlSerializer serializes an enumeration member.

SoapIgnoreAttribute

Indica all'elemento XmlSerializer di non serializzare il campo pubblico o il valore della proprietà di lettura/scrittura pubblica.Instructs the XmlSerializer not to serialize the public field or public read/write property value.

SoapIncludeAttribute

Consente il riconoscimento di un tipo da parte della classe XmlSerializer quando un oggetto viene serializzato o deserializzato nel formato XML SOAP codificato.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

SoapReflectionImporter

Genera mapping a messaggi con codifica SOAP da tipi .NET Framework o informazioni dei metodi di servizi Web.Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.

SoapSchemaExporter

Inserisce negli oggetti XmlSchema definizioni di tipi di dati XML Schema per tipi .NET Framework che vengono serializzati usando la codifica SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.

SoapSchemaImporter

Usata in .NET Framework per generare mapping dei tipi interni .NET Framework per parti di messaggi con codifica SOAP in un documento WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.

SoapSchemaMember

Rappresenta alcuni attributi di un elemento XSD <part> in un documento WSDL per la generazione di classi dal documento.Represents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.

SoapTypeAttribute

Consente di controllare lo schema generato dalla classe XmlSerializer quando un'istanza di classe viene serializzata come elemento XML SOAP codificato.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.

UnreferencedObjectEventArgs

Consente di ottenere dati per l'oggetto noto, ma senza riferimenti, trovato durante la deserializzazione in un flusso XML SOAP codificato.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.

XmlAnyAttributeAttribute

Consente di specificare l'inserimento di qualsiasi attributo XML nel membro, ovvero in un campo che restituisce una matrice di oggetti XmlAttribute.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.

XmlAnyElementAttribute

Specifica che il membro, ovvero un campo che restituisce una matrice di oggetti XmlElement o XmlNode, può contenere oggetti che rappresentano qualsiasi elemento XML privo di membro corrispondente nell'oggetto da serializzare o deserializzare.Specifies that the member (a field that returns an array of XmlElement or XmlNode objects) contains objects that represent any XML element that has no corresponding member in the object being serialized or deserialized.

XmlAnyElementAttributes

Rappresenta una raccolta di oggetti XmlAnyElementAttribute.Represents a collection of XmlAnyElementAttribute objects.

XmlArrayAttribute

Specifica che XmlSerializer deve serializzare un determinato membro della classe come matrice di elementi XML.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements.

XmlArrayItemAttribute

Rappresenta un attributo che specifica i tipi derivati che XmlSerializer può inserire in una matrice serializzata.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array.

XmlArrayItemAttributes

Rappresenta una raccolta di oggetti XmlArrayItemAttribute.Represents a collection of XmlArrayItemAttribute objects.

XmlAttributeAttribute

Specifica che XmlSerializer deve serializzare il membro della classe come attributo XML.Specifies that the XmlSerializer must serialize the class member as an XML attribute.

XmlAttributeEventArgs

Fornisce dati per l'evento UnknownAttribute.Provides data for the UnknownAttribute event.

XmlAttributeOverrides

Consente di sottoporre a override gli attributi di una proprietà, di un campo e di una classe quando si utilizza XmlSerializer per serializzare o deserializzare un oggettoAllows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.

XmlAttributes

Rappresenta un insieme di oggetti attributo che controlla come XmlSerializer serializza e deserializza un oggetto.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.

XmlChoiceIdentifierAttribute

Specifica che è possibile utilizzare un'enumerazione per rilevare ulteriormente il membro.Specifies that the member can be further detected by using an enumeration.

XmlCodeExporter

Genera tipi e dichiarazioni di attributi da informazioni dei mapping interni dei tipi per dichiarazioni di elementi dello schema XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations.

XmlElementAttribute

Indica che una proprietà o un campo public rappresenta un elemento XML quando XmlSerializer serializza o deserializza l'oggetto in cui è contenuto.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.

XmlElementAttributes

Rappresenta un insieme di oggetti XmlElementAttribute utilizzato dalla classe XmlSerializer per eseguire l'override della modalità predefinita di serializzazione di una classe.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.

XmlElementEventArgs

Fornisce dati per l'evento UnknownElement.Provides data for the UnknownElement event.

XmlEnumAttribute

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento XmlSerializer.Controls how the XmlSerializer serializes an enumeration member.

XmlIgnoreAttribute

Fa in modo che il metodo Serialize(TextWriter, Object) di XmlSerializer non serializzi il campo pubblico o il valore pubblico della proprietà in lettura/scrittura.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value.

XmlIncludeAttribute

Consente all'XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object.

XmlMapping

Supporta i mapping tra i tipi .NET Framework e i tipi di dati XML Schema.Supports mappings between .NET Framework types and XML Schema data types.

XmlMemberMapping

Esegue il mapping di un'entità di codice di un metodo di servizio Web .NET Framework a un elemento di un messaggio nel linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language).Maps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.

XmlMembersMapping

Fornisce i mapping tra i metodi di servizio Web di .NET Framework e i messaggi WSDL (Web Service Description Language) definiti per i servizi Web SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlNamespaceDeclarationsAttribute

Specifica che la proprietà, il parametro, il valore restituito o il membro di classe di destinazione contiene prefissi associati agli spazi dei nomi utilizzati all'interno di un documento XML.Specifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document.

XmlNodeEventArgs

Fornisce dati per l'evento UnknownNode.Provides data for the UnknownNode event.

XmlReflectionImporter

Genera mapping a dichiarazioni di elementi dello schema XML, incluse parti di messaggi XSD (XML Schema Definition) letterali in un documento nel linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language), per tipi .NET Framework o informazioni dei metodi di servizi Web.Generates mappings to XML schema element declarations, including literal XML Schema Definition (XSD) message parts in a Web Services Description Language (WSDL) document, for .NET Framework types or Web service method information.

XmlReflectionMember

Fornisce i mapping tra le entità di codice dei metodi di servizio Web di .NET Framework e il contenuto dei messaggi nel linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) definiti per i servizi Web SOAP.Provides mappings between code entities in .NET Framework Web service methods and the content of Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlRootAttribute

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.

XmlSchemaEnumerator

Consente l'iterazione su un insieme di oggetti XmlSchema.Enables iteration over a collection of XmlSchema objects.

XmlSchemaExporter

Inserisce negli oggetti XmlSchema dichiarazioni di elementi dello schema XML presenti in oggetti mapping dei tipi.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects.

XmlSchemaImporter

Genera mapping interni a tipi .NET Framework per dichiarazioni di elementi dello schema XML, incluse parti di messaggi XSD letterali in un documento WSDL.Generates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.

XmlSchemaProviderAttribute

Quando viene applicata a un tipo, archivia il nome di un metodo statico del tipo che restituisce uno schema XML e una classe XmlQualifiedName (o XmlSchemaType per i tipi anonimi) che controlla la serializzazione del tipo.When applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName (or XmlSchemaType for anonymous types) that controls the serialization of the type.

XmlSchemas

Rappresenta l'insieme di schemi XML.Represents the collection of XML schemas.

XmlSerializationGeneratedCode

Classe astratta che costituisce la classe base per XmlSerializationReader e XmlSerializationWriter e contiene metodi comuni a entrambi questi tipi.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.

XmlSerializationReader

Controlla la deserializzazione effettuata dalla classe XmlSerializer.Controls deserialization by the XmlSerializer class.

XmlSerializationReader.CollectionFixup

Contiene un'istanza del delegato XmlSerializationCollectionFixupCallback, oltre agli input del metodo. Fornisce inoltre i parametri del metodo.Holds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.

XmlSerializationReader.Fixup

Contiene un'istanza del delegato XmlSerializationFixupCallback, oltre agli input del metodo e funge da parametro per il metodo.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.

XmlSerializationWriter

Rappresenta una classe astratta utilizzata per controllare la serializzazione effettuata dalla classe XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class.

XmlSerializer

Serializza e deserializza oggetti in e da documenti XML.Serializes and deserializes objects into and from XML documents. XmlSerializer consente di controllare le modalità di codifica degli oggetti in XML.The XmlSerializer enables you to control how objects are encoded into XML.

XmlSerializerAssemblyAttribute

Applicata a un proxy client di un servizio Web, consente di specificare un assembly contenente serializzatori personalizzati.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.

XmlSerializerFactory

Crea versioni tipizzate della classe XmlSerializer per una serializzazione più efficiente.Creates typed versions of the XmlSerializer for more efficient serialization.

XmlSerializerImplementation

Definisce il reader, il writer e i metodi per i serializzatori tipizzati generati in precedenza.Defines the reader, writer, and methods for pre-generated, typed serializers.

XmlSerializerNamespaces

Contiene gli spazi dei nomi e i prefissi XML che XmlSerializer usa per generare i nomi completi in un'istanza di un documento XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

XmlSerializerVersionAttribute

Quando questo attributo viene applicato a un assembly, indica che il codice è stato generato dall'infrastruttura di serializzazione e può essere riutilizzato in modo da migliorare le prestazioni.Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly.

XmlTextAttribute

Indica a XmlSerializer che il membro deve essere trattato come testo XML quando la classe in cui è contenuto viene serializzata o deserializzata.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.

XmlTypeAttribute

Controlla lo schema XML generato quando la destinazione dell'attributo viene serializzata dalla classe XmlSerializer.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

XmlTypeMapping

In questa classe è contenuto il mapping di un tipo in un altro.Contains a mapping of one type to another.

Struct

XmlDeserializationEvents

Contiene campi che possono essere utilizzati per passare delegati di evento a un metodo Deserialize thread-safe di XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

Interfacce

IXmlSerializable

Fornisce una formattazione personalizzata per la serializzazione e la deserializzazione XML.Provides custom formatting for XML serialization and deserialization.

IXmlTextParser

Stabilisce una proprietà Normalized che deve essere utilizzata dall'infrastruttura .NET Framework.Establishes a Normalized property for use by the .NET Framework infrastructure.

Enumerazioni

CodeGenerationOptions

Specifica diverse opzioni da usare quando vengono generati tipi .NET da usare con un servizio Web XML.Specifies various options to use when generating .NET types for use with an XML Web Service.

XmlMappingAccess

Specifica se un mapping è in lettura, scrittura o in entrambe le modalità.Specifies whether a mapping is read, write, or both.

Delegati

UnreferencedObjectEventHandler

Rappresenta il metodo di gestione dell'evento UnreferencedObject di un oggetto XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer.

XmlAttributeEventHandler

Rappresenta il metodo che gestisce UnknownAttribute.Represents the method that handles the UnknownAttribute

XmlElementEventHandler

Rappresenta il metodo di gestione dell'evento UnknownElement di un oggetto XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer.

XmlNodeEventHandler

Rappresenta il metodo di gestione dell'evento UnknownNode di un oggetto XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer.

XmlSerializationCollectionFixupCallback

Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di tipi di dati XML con codifica SOAP mappati a insiemi o enumerazioni.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.

XmlSerializationFixupCallback

Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di dati XML con codifica SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.

XmlSerializationReadCallback

Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di tipi da dati XML non di primo livello con codifica SOAP.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.

XmlSerializationWriteCallback

Delegato che viene utilizzato dalla classe XmlSerializer per la serializzazione di tipi da dati XML non di primo livello con codifica SOAP.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

Commenti

La classe centrale nello spazio dei nomi è il XmlSerializer classe.The central class in the namespace is the XmlSerializer class. Per usare questa classe, usare il XmlSerializer costruttore per creare un'istanza della classe usando il tipo dell'oggetto da serializzare.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Una volta un XmlSerializer viene creato, creare un'istanza dell'oggetto da serializzare.Once an XmlSerializer is created, create an instance of the object to serialize. È anche necessario creare un oggetto per scrivere il file in un documento o flusso, ad esempio un Stream, TextWriter, o XmlWriter.You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. È quindi possibile chiamare il Serialize metodo per convertire l'oggetto in un documento XML.You can then call the Serialize method to convert the object into an XML document.

Per deserializzare un oggetto da un documento XML, creare un oggetto adatto per leggere il documento o flusso (anche in questo caso, un Stream, TextWriter, o XmlWriter).To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Richiamare il Deserialize metodo durante il cast dell'oggetto risulta per il tipo dell'oggetto originale (che è stato serializzato).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

Per controllare ulteriormente la serializzazione, la System.Xml.Serialization dello spazio dei nomi contiene numerosi Attribute classi che possono essere applicate ai membri di una classe.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Ad esempio, se una classe contiene un membro che verrà serializzato come elemento XML, è possibile applicare il XmlElementAttribute al membro dell'attributo.For example, if a class contains a member that will be serialized as an XML element, you can apply the XmlElementAttribute attribute to the member. Quando si applica l'attributo, è possibile specificare i dettagli, ad esempio effettivo XML elemento nome usando il ElementName proprietà.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Per un elenco completo di tutti gli attributi, vedere il XmlSerializer Cenni preliminari sulla classe.For a complete list of all the attributes, see the XmlSerializer class overview.