Spazio dei nomi System.Xml.Serialization

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Nello spazio dei nomi System.Xml.Serialization sono contenute classi utilizzate per serializzare oggetti in documenti o flussi di formato XML.

La classe centrale nello spazio dei nomi è la classe XmlSerializer. Per utilizzarla, crearne un'istanza mediante il costruttore XmlSerializer usando il tipo dell'oggetto da serializzare. Dopo aver creato un'istanza della classe XmlSerializer, creare un'istanza dell'oggetto da serializzare. È inoltre necessario creare un oggetto per scrivere il file in un documento o flusso, ad esempio Stream, TextWriter o XmlWriter. A questo punto è possibile chiamare il metodo Serialize per convertire l'oggetto in un documento XML.

Per deserializzare un oggetto da un documento XML, creare un oggetto adatto a consentire la lettura del documento o del flusso, ovvero Stream, TextWriter o XmlWriter e richiamare il metodo Deserialize mentre si esegue il cast dell'oggetto ottenuto al tipo dell'oggetto originale che era stato serializzato.

Nello spazio dei nomi System.Xml.Serialization sono contenute varie classi Attribute che possono essere applicate ai membri di una classe per controllare ulteriormente la serializzazione. Se, ad esempio, in una classe è presente un membro che verrà serializzato come elemento XML, a tale membro può essere applicato l'attributo XmlElementAttribute. Quando si applica l'attributo, utilizzando la proprietà ElementName è possibile specificare dettagli quali il nome dell'elemento XML effettivo. Per un elenco completo di tutti gli attributi, vedere i cenni preliminari sulla classe XmlSerializer.

Classi

	Classe	Descrizione
	CodeExporter	Rappresenta una classe in grado di generare codice proxy da una rappresentazione XML di una struttura di dati.
	CodeIdentifier	Fornisce un metodo statico per la conversione di testo di input in nomi per entità di codice.
	CodeIdentifiers	Gestisce un gruppo di nomi di entità di codice o mapping di tipi correlati generati dall'infrastruttura di serializzazione XML di .NET Framework.
	ImportContext	Descrive il contesto in cui un insieme di schemi viene associato a entità di codice .NET Framework.
	SchemaImporter	Descrive un'utilità di importazione dello schema.
	SoapAttributeAttribute	Specifica che XmlSerializer deve serializzare il membro della classe come attributo SOAP codificato.
	SoapAttributeOverrides	Consente di eseguire l'override di attributi applicati a proprietà, campi e classi in caso di utilizzo di un XmlSerializer per la serializzazione o la deserializzazione di un oggetto con codifica SOAP.
	SoapAttributes	Rappresenta un insieme di oggetti attributo che consente di controllare le modalità di serializzazione e deserializzazione di metodi SOAP mediante la classe XmlSerializer.
	SoapCodeExporter	Genera tipi e dichiarazioni di attributi da informazioni dei mapping interni dei tipi per parti di messaggi con codifica SOAP definite in un documento WSDL.
	SoapElementAttribute	Consente di specificare che il valore del membro pubblico venga serializzato dalla classe XmlSerializer come elemento XML SOAP codificato.
	SoapEnumAttribute	Consente di controllare le modalità di serializzazione di un membro di enumerazione utilizzate nella classe XmlSerializer.
	SoapIgnoreAttribute	Consente di fornire istruzioni alla classe XmlSerializer per evitare la serializzazione del campo pubblico o del valore della proprietà di lettura/scrittura pubblica.
	SoapIncludeAttribute	Consente il riconoscimento di un tipo da parte della classe XmlSerializer quando un oggetto viene serializzato o deserializzato nel formato XML SOAP codificato.
	SoapReflectionImporter	Genera mapping a messaggi con codifica SOAP da tipi .NET Framework o informazioni dei metodi di servizi Web.
	SoapSchemaExporter	Inserisce negli oggetti XmlSchema definizioni di tipi di dati dello schema XML per tipi .NET Framework che vengono serializzati utilizzando la codifica SOAP.
	SoapSchemaImporter	Utilizzata in .NET Framework per generare mapping interni a tipi .NET Framework per parti di messaggi con codifica SOAP in un documento WSDL.
	SoapSchemaMember	Rappresenta alcuni attributi di un elemento <part> XSD in un documento WSDL per la generazione di classi dal documento.
	SoapTypeAttribute	Consente di controllare lo schema generato dalla classe XmlSerializer quando un'istanza di classe viene serializzata come elemento XML SOAP codificato.
	UnreferencedObjectEventArgs	Consente di ottenere dati per l'oggetto noto, ma senza riferimenti, trovato durante la deserializzazione in un flusso XML SOAP codificato.
	XmlAnyAttributeAttribute	Consente di specificare l'inserimento di qualsiasi attributo XML nel membro, ovvero in un campo che restituisce una matrice di oggetti XmlAttribute.
	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.
	XmlAnyElementAttributes	Rappresenta un insieme di oggetti XmlAnyElementAttribute.
	XmlArrayAttribute	Specifica che XmlSerializer deve serializzare un determinato membro della classe come matrice di elementi XML.
	XmlArrayItemAttribute	Specifica i tipi derivati che XmlSerializer può inserire in una matrice serializzata.
	XmlArrayItemAttributes	Rappresenta un insieme di oggetti XmlArrayItemAttribute.
	XmlAttributeAttribute	Specifica che XmlSerializer deve serializzare il membro della classe come attributo XML.
	XmlAttributeEventArgs	Fornisce i dati per l'evento UnknownAttribute.
	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 oggetto
	XmlAttributes	Rappresenta un insieme di oggetti attributo che controlla come XmlSerializer serializza e deserializza un oggetto.
	XmlChoiceIdentifierAttribute	Specifica che è possibile utilizzare un'enumerazione per rilevare ulteriormente il membro.
	XmlCodeExporter	Genera tipi e dichiarazioni di attributi da informazioni dei mapping interni dei tipi per dichiarazioni di elementi dello schema XML.
	XmlElementAttribute	Indica che una proprietà o un campo public rappresenta un elemento XML quando XmlSerializer serializza o deserializza l'oggetto in cui è contenuto.
	XmlElementAttributes	Rappresenta un insieme di oggetti XmlElementAttribute utilizzato dalla classe XmlSerializer per eseguire l'override della modalità predefinita di serializzazione di una classe.
	XmlElementEventArgs	Fornisce i dati per l'evento UnknownElement.
	XmlEnumAttribute	Consente di controllare le modalità di serializzazione di un membro di enumerazione utilizzate nella classe XmlSerializer.
	XmlIgnoreAttribute	Fa in modo che il metodo Serialize di XmlSerializer non serializzi il campo pubblico o il valore pubblico della proprietà in lettura/scrittura.
	XmlIncludeAttribute	Consente all'XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto.
	XmlMapping	Supporta i mapping tra i tipi .NET Framework e i tipi di dati dello schema XML.
	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).
	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.
	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.
	XmlNodeEventArgs	Fornisce i dati per l'evento UnknownNode.
	XmlReflectionImporter	Genera mapping a dichiarazioni di elementi dello schema XML, incluse parti di messaggi di definizione di schemi XML (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.
	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.
	XmlRootAttribute	Controlla la serializzazione XML della destinazione dell'attributo come un elemento di primo livello.
	XmlSchemaEnumerator	Consente l'iterazione su un insieme di oggetti XmlSchema.
	XmlSchemaExporter	Inserisce negli oggetti XmlSchema dichiarazioni di elementi dello schema XML presenti in oggetti mapping dei tipi.
	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.
	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 che controlla la serializzazione del tipo.
	XmlSchemas	Rappresenta l'insieme di schemi XML.
	XmlSerializationGeneratedCode	Classe astratta che costituisce la classe base per XmlSerializationReader e XmlSerializationWriter e contiene metodi comuni a entrambi questi tipi.
	XmlSerializationReader	Controlla la deserializzazione effettuata dalla classe XmlSerializer.
	XmlSerializationReader.CollectionFixup	Contiene un'istanza del delegato XmlSerializationCollectionFixupCallback, oltre agli input del metodo. Fornisce inoltre i parametri del metodo.
	XmlSerializationReader.Fixup	Contiene un'istanza del delegato XmlSerializationFixupCallback, oltre agli input del metodo e funge da parametro per il metodo.
	XmlSerializationWriter	Classe astratta utilizzata per controllare la serializzazione effettuata dalla classe XmlSerializer.
	XmlSerializer	Serializza e deserializza oggetti in e da documenti XML. XmlSerializer consente di controllare le modalità di codifica degli oggetti in XML.
	XmlSerializerAssemblyAttribute	Applicata a un proxy client di un servizio Web, consente di specificare un assembly contenente serializzatori personalizzati.
	XmlSerializerFactory	Crea versioni tipizzate della classe XmlSerializer per una serializzazione più efficiente.
	XmlSerializerImplementation	Definisce il reader, il writer e i metodi per i serializzatori tipizzati generati in precedenza.
	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.
	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.
	XmlTextAttribute	Indica a XmlSerializer che il membro deve essere trattato come testo XML quando la classe in cui è contenuto viene serializzata o deserializzata.
	XmlTypeAttribute	Controlla lo schema XML generato quando la destinazione dell'attributo viene serializzata dalla classe XmlSerializer.
	XmlTypeMapping	In questa classe è contenuto il mapping di un tipo in un altro.

Interfacce

	Interfaccia	Descrizione
	IXmlSerializable	Fornisce una formattazione personalizzata per la serializzazione e la deserializzazione XML.
	IXmlTextParser	Stabilisce una proprietà Normalized che deve essere utilizzata dall'infrastruttura .NET Framework.

Strutture

	Struttura	Descrizione
	XmlDeserializationEvents	Contiene campi che possono essere utilizzati per passare delegati di evento a un metodo Deserialize thread-safe di XmlSerializer.

Delegati

	Delegato	Descrizione
	UnreferencedObjectEventHandler	Rappresenta il metodo di gestione dell'evento UnreferencedObject di un oggetto XmlSerializer.
	XmlAttributeEventHandler	Rappresenta il metodo che gestisce UnknownAttribute.
	XmlElementEventHandler	Rappresenta il metodo di gestione dell'evento UnknownElement di un oggetto XmlSerializer.
	XmlNodeEventHandler	Rappresenta il metodo di gestione dell'evento UnknownNode di un oggetto XmlSerializer.
	XmlSerializationCollectionFixupCallback	Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di tipi di dati XML con codifica SOAP mappati a insiemi o enumerazioni.
	XmlSerializationFixupCallback	Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di dati XML con codifica SOAP.
	XmlSerializationReadCallback	Delegato utilizzato dalla classe XmlSerializer per la deserializzazione di tipi da dati XML non di primo livello con codifica SOAP.
	XmlSerializationWriteCallback	Delegato che viene utilizzato dalla classe XmlSerializer per la serializzazione di tipi da dati XML non di primo livello con codifica SOAP.

Enumerazioni

	Enumerazione	Descrizione
	CodeGenerationOptions	Specifica diverse opzioni da utilizzare quando vengono generati tipi .NET Framework da utilizzare con un servizio Web XML.
	XmlMappingAccess	Specifica se un mapping è in lettura, scrittura o in entrambe le modalità.