System.Xml.Serialization Spazio dei nomi

Contiene le classi utilizzate per serializzare oggetti in flussi o documenti in formato XML.

Classi

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.

ImportContext

Descrive il contesto in cui un insieme di schemi viene associato a entità di codice .NET.

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 elemento XmlSerializer per la serializzazione o la deserializzazione di un oggetto con codifica SOAP.

SoapAttributes

Rappresenta una raccolta di oggetti attributo che controlla le modalità di serializzazione e deserializzazione di metodi SOAP mediante l'elemento XmlSerializer.

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.

SoapElementAttribute

Consente di specificare che il valore del membro pubblico venga serializzato dalla classe XmlSerializer come elemento XML SOAP codificato.

SoapEnumAttribute

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento XmlSerializer.

SoapIgnoreAttribute

Indica all'elemento XmlSerializer di non serializzare il campo pubblico o il 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 o informazioni dei metodi di servizi Web.

SoapSchemaExporter

Inserisce negli oggetti XmlSchema definizioni di tipi di dati XML Schema per tipi .NET Framework che vengono serializzati usando la codifica SOAP.

SoapSchemaImporter

Usata in .NET Framework per generare mapping dei tipi interni .NET Framework per parti di messaggi con codifica SOAP in un documento WSDL.

SoapSchemaMember

Rappresenta alcuni attributi di un elemento XSD <part> 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 una raccolta di oggetti XmlAnyElementAttribute.

XmlArrayAttribute

Specifica che XmlSerializer deve serializzare un determinato membro della classe come matrice di elementi XML.

XmlArrayItemAttribute

Rappresenta un attributo che specifica i tipi derivati che XmlSerializer può inserire in una matrice serializzata.

XmlArrayItemAttributes

Rappresenta una raccolta di oggetti XmlArrayItemAttribute.

XmlAttributeAttribute

Specifica che XmlSerializer deve serializzare il membro della classe come attributo XML.

XmlAttributeEventArgs

Fornisce 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 rilevare ulteriormente il membro tramite un'enumerazione.

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 una raccolta di oggetti XmlElementAttribute usati da XmlSerializer per eseguire l'override della modalità predefinita di serializzazione di una classe.

XmlElementEventArgs

Fornisce dati per l'evento UnknownElement.

XmlEnumAttribute

Controlla la modalità di serializzazione di un membro di enumerazione usata dall'elemento XmlSerializer.

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.

XmlIncludeAttribute

Consente all'XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto.

XmlMapping

Supporta i mapping tra tipi .NET e tipi di dati XML Schema.

XmlMemberMapping

Esegue il mapping di un'entità di codice di un metodo di servizio Web .NET a un elemento di un messaggio nel linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language).

XmlMembersMapping

Specifica i mapping tra i metodi servizio Web .NET 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 della classe di destinazione contiene prefissi associati a spazi dei nomi usati all'interno di un documento XML.

XmlNodeEventArgs

Fornisce dati per l'evento UnknownNode.

XmlReflectionImporter

Genera mapping a dichiarazioni di elementi XML Schema, 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 o informazioni dei metodi di servizi Web.

XmlReflectionMember

Specifica i mapping tra le entità di codice dei metodi di servizio Web .NET 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 radice XML.

XmlSchemaEnumerator

Consente l'iterazione su una raccolta 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 per dichiarazioni di elementi XML Schema, incluse parti di messaggi XSD letterali in un documento WSDL.

XmlSchemaProviderAttribute

Se applicato a un tipo, archivia il nome di un metodo statico del tipo che restituisce uno schema XML e un XmlQualifiedName (o XmlSchemaType per i tipi anonimi) che controlla la serializzazione del tipo.

XmlSchemas

Rappresenta la raccolta 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

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

Struct

XmlDeserializationEvents

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

Interfacce

IXmlSerializable

Fornisce la formattazione personalizzata per la serializzazione e deserializzazione XML.

IXmlTextParser

Definisce una proprietà Normalized che deve essere usata dall'infrastruttura .NET.

Enumerazioni

CodeGenerationOptions

Specifica diverse opzioni da usare quando vengono generati tipi .NET da usare con un servizio Web XML.

XmlMappingAccess

Specifica se un mapping è in lettura, scrittura o in entrambe le modalità.

Delegati

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.

Commenti

La classe centrale nello spazio dei nomi è la XmlSerializer classe . Per usare questa classe, usare il XmlSerializer costruttore per creare un'istanza della classe usando il tipo dell'oggetto per serializzare. Dopo aver creato un oggetto XmlSerializer , creare un'istanza dell'oggetto per serializzare. È anche necessario creare un oggetto per scrivere il file in un documento o in un flusso, ad esempio , StreamTextWritero XmlWriter. È quindi possibile chiamare il metodo per convertire l'oggetto Serialize in un documento XML.

Per deserializzare un oggetto da un documento XML, creare un oggetto adatto per leggere il documento o il flusso (di nuovo, un Streamoggetto , TextWritero XmlWriter). Richiamare il metodo durante il Deserialize cast dell'oggetto risultante al tipo dell'oggetto originale (serializzato).

Per controllare ulteriormente la serializzazione, lo System.Xml.Serialization spazio dei nomi contiene diverse Attribute classi che possono essere applicate ai membri di una classe. Ad esempio, se una classe contiene un membro che verrà serializzato come elemento XML, è possibile applicare l'attributo XmlElementAttribute al membro. Quando si applica l'attributo, è possibile specificare i dettagli, ad esempio il nome effettivo dell'elemento XML usando la ElementName proprietà . Per un elenco completo di tutti gli attributi, vedere la panoramica della XmlSerializer classe.