System.Xml.Serialization Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Contiene classi utilizzate per serializzare oggetti in documenti o flussi in formato XML.
Classi
| Nome | Descrizione |
|---|---|
| CodeExporter |
Rappresenta una classe che può generare codice proxy da una rappresentazione XML di una struttura di dati. |
| CodeIdentifier |
Fornisce metodi statici per convertire il testo di input in nomi per le entità di codice. |
| CodeIdentifiers |
Gestisce un gruppo di nomi per le entità di codice correlate o i mapping dei tipi generati da . Infrastruttura di serializzazione XML di NET. |
| ImportContext |
Descrive il contesto in cui un set di schemi è associato a entità di codice .NET. |
| SchemaImporter |
Descrive un'utilità di importazione dello schema. |
| SoapAttributeAttribute |
Specifica che il XmlSerializer deve serializzare il membro della classe come attributo SOAP codificato. |
| SoapAttributeOverrides |
Consente di eseguire l'override degli attributi applicati a proprietà, campi e classi quando si utilizza un XmlSerializer oggetto per serializzare o deserializzare un oggetto come SOAP codificato. |
| SoapAttributes |
Rappresenta una raccolta di oggetti attributo che controllano la XmlSerializer modalità di serializzazione e deserializza i metodi SOAP. |
| SoapCodeExporter |
Genera tipi e dichiarazioni di attributi da informazioni di mapping dei tipi interne per parti di messaggio con codifica SOAP definite in un documento WSDL. |
| SoapElementAttribute |
Specifica che il valore del membro pubblico deve essere serializzato dal XmlSerializer come elemento XML SOAP codificato. |
| SoapEnumAttribute |
Controlla il modo in cui il XmlSerializer serializza un membro di enumerazione. |
| SoapIgnoreAttribute |
Indica al XmlSerializer di non serializzare il campo pubblico o il valore della proprietà di lettura/scrittura pubblica. |
| SoapIncludeAttribute |
Consente al XmlSerializer di riconoscere un tipo quando serializza o deserializza un oggetto come XML SOAP codificato. |
| SoapReflectionImporter |
Genera mapping a messaggi con codifica SOAP da tipi .NET o informazioni sul metodo del servizio Web. |
| SoapSchemaExporter |
Popola gli XmlSchema oggetti con definizioni dei tipi di dati xml Schema per i tipi .NET serializzati tramite la codifica SOAP. |
| SoapSchemaImporter |
Usato all'interno di .NET Framework per generare mapping interni ai tipi .NET per parti di messaggio con codifica SOAP in un documento WSDL. |
| SoapSchemaMember |
Rappresenta determinati attributi di un elemento XSD < |
| SoapTypeAttribute |
Controlla lo schema generato dal XmlSerializer quando un'istanza di classe viene serializzata come XML con codifica SOAP. |
| UnreferencedObjectEventArgs |
Fornisce dati per l'oggetto noto, ma non referenziato, trovato in un flusso XML SOAP codificato durante la deserializzazione. |
| XmlAnyAttributeAttribute |
Specifica che il membro (un campo che restituisce una matrice di oggetti XmlAttribute) può contenere qualsiasi attributo XML. |
| XmlAnyElementAttribute |
Specifica che il membro (un campo che restituisce una matrice di oggetti XmlElement o XmlNode) contiene oggetti che rappresentano qualsiasi elemento XML che non dispone di alcun membro corrispondente nell'oggetto da serializzare o deserializzare. |
| XmlAnyElementAttributes |
Rappresenta una raccolta di XmlAnyElementAttribute oggetti . |
| XmlArrayAttribute |
Specifica che il XmlSerializer deve serializzare un membro di classe specifico come matrice di elementi XML. |
| XmlArrayItemAttribute |
Rappresenta un attributo che specifica i tipi derivati che l'XmlSerializer può inserire in una matrice serializzata. |
| XmlArrayItemAttributes |
Rappresenta una raccolta di XmlArrayItemAttribute oggetti . |
| XmlAttributeAttribute |
Specifica che il XmlSerializer deve serializzare il membro della classe come attributo XML. |
| XmlAttributeEventArgs |
Fornisce i dati per l'evento UnknownAttribute. |
| XmlAttributeOverrides |
Consente di eseguire l'override degli attributi di proprietà, campo e classe quando si utilizza XmlSerializer per serializzare o deserializzare un oggetto. |
| XmlAttributes |
Rappresenta una raccolta di oggetti attributo che controllano il modo in cui serializza XmlSerializer e deserializza un oggetto. |
| XmlChoiceIdentifierAttribute |
Specifica che il membro può essere rilevato ulteriormente utilizzando un'enumerazione . |
| XmlCodeExporter |
Genera tipi e dichiarazioni di attributi dalle informazioni di mapping dei tipi interne per le dichiarazioni degli elementi di XML Schema. |
| XmlElementAttribute |
Indica che un campo pubblico o una proprietà rappresenta un elemento XML quando la XmlSerializer serializza o deserializza l'oggetto che lo contiene. |
| XmlElementAttributes |
Rappresenta una raccolta di XmlElementAttribute oggetti utilizzati da per eseguire l'override XmlSerializer del modo predefinito in cui serializza una classe. |
| XmlElementEventArgs |
Fornisce i dati per l'evento UnknownElement. |
| XmlEnumAttribute |
Controlla il modo in cui il XmlSerializer serializza un membro di enumerazione. |
| XmlIgnoreAttribute |
Indica al metodo Serialize(TextWriter, Object) del XmlSerializer di non serializzare il valore della proprietà pubblica o di lettura/scrittura pubblica. |
| XmlIncludeAttribute |
Consente al 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 in un metodo del servizio Web .NET a un elemento in un messaggio WSDL (Web Services Description Language). |
| XmlMembersMapping |
Fornisce mapping tra i metodi del servizio Web .NET e i messaggi WSDL (Web Services Description Language) definiti per i servizi Web SOAP. |
| XmlNamespaceDeclarationsAttribute |
Specifica che la proprietà di destinazione, il parametro, il valore restituito o il membro della classe 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 alle dichiarazioni degli elementi dello schema XML, incluse le parti di messaggio XSD (XML Schema Definition) letterali in un documento WSDL (Web Services Description Language) per i tipi .NET o le informazioni sul metodo del servizio Web. |
| XmlReflectionMember |
Fornisce mapping tra entità di codice nei metodi del servizio Web .NET e il contenuto dei messaggi WSDL (Web Services Description Language) definiti per i servizi Web SOAP. |
| XmlRootAttribute |
Controlla la serializzazione XML della destinazione dell'attributo come elemento radice XML. |
| XmlSchemaEnumerator |
Abilita l'iterazione su una raccolta di XmlSchema oggetti. |
| XmlSchemaExporter |
Popola gli XmlSchema oggetti con dichiarazioni di elementi dello schema XML presenti negli oggetti di mapping dei tipi. |
| XmlSchemaImporter |
Genera mapping interni ai tipi .NET per le dichiarazioni degli elementi di XML Schema, incluse le parti di messaggio XSD letterali in un documento WSDL. |
| XmlSchemaProviderAttribute |
Se applicato a un tipo, archivia il nome di un metodo statico del tipo che restituisce un XML Schema e un XmlQualifiedName (o XmlSchemaType per i tipi anonimi) che controlla la serializzazione del tipo. |
| XmlSchemas |
Rappresenta la raccolta di XML Schema. |
| XmlSerializationGeneratedCode |
Classe astratta che è la classe base per XmlSerializationReader e XmlSerializationWriter che contiene metodi comuni a entrambi questi tipi. |
| XmlSerializationReader |
Controlla la deserializzazione dalla XmlSerializer classe . |
| XmlSerializationReader.CollectionFixup |
Contiene un'istanza XmlSerializationCollectionFixupCallback del delegato, oltre agli input del metodo, fornisce anche i parametri del metodo. |
| XmlSerializationReader.Fixup |
Contiene un'istanza XmlSerializationFixupCallback del delegato, oltre agli input del metodo, funge anche da parametro per il metodo . |
| XmlSerializationWriter |
Rappresenta una classe astratta utilizzata per il controllo della serializzazione da parte della XmlSerializer classe . |
| XmlSerializer |
Serializza e deserializza gli oggetti in e dai documenti XML. XmlSerializer consente di controllare il modo in cui gli oggetti vengono codificati in XML. |
| XmlSerializerAssemblyAttribute |
Applicato a un proxy client del servizio Web, consente di specificare un assembly che contiene serializzatori personalizzati. |
| XmlSerializerFactory |
Crea versioni tipate di XmlSerializer per una serializzazione più efficiente. |
| XmlSerializerImplementation |
Definisce il lettore, il writer e i metodi per serializzatori tipizzato pre-generati. |
| XmlSerializerNamespaces |
Contiene gli spazi dei nomi XML e i XmlSerializer prefissi utilizzati da per generare nomi qualificati in un'istanza di documento XML. |
| XmlSerializerVersionAttribute |
Indica che il codice è stato generato dall'infrastruttura di serializzazione e può essere riutilizzato per migliorare le prestazioni, quando questo attributo viene applicato a un assembly. |
| XmlTextAttribute |
Indica al XmlSerializer che il membro deve essere considerato come testo XML quando la classe che lo contiene viene serializzata o deserializzata. |
| XmlTypeAttribute |
Controlla lo schema XML generato quando la destinazione dell'attributo viene serializzata dal XmlSerializer. |
| XmlTypeMapping |
Contiene un mapping di un tipo a un altro. |
Struct
| Nome | Descrizione |
|---|---|
| XmlDeserializationEvents |
Contiene campi che possono essere usati per passare delegati di eventi a un metodo di Deserialize thread-safe del XmlSerializer. |
Interfacce
| Nome | Descrizione |
|---|---|
| IXmlSerializable |
Fornisce formattazione personalizzata per la serializzazione e la deserializzazione XML. |
| IXmlTextParser |
Stabilisce una Normalized proprietà per l'uso da parte dell'infrastruttura .NET. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| CodeGenerationOptions |
Specifica varie opzioni da usare durante la generazione di tipi .NET da usare con un servizio Web XML. |
| XmlMappingAccess |
Specifica se un mapping è di lettura, scrittura o entrambi. |
Delegati
| Nome | Descrizione |
|---|---|
| UnreferencedObjectEventHandler |
Rappresenta il metodo che gestisce l'evento UnreferencedObject di un oggetto XmlSerializer. |
| XmlAttributeEventHandler |
Rappresenta il metodo che gestisce l'oggetto UnknownAttribute. |
| XmlElementEventHandler |
Rappresenta il metodo che gestisce l'evento UnknownElement di un oggetto XmlSerializer. |
| XmlNodeEventHandler |
Rappresenta il metodo che gestisce l'evento UnknownNode di un oggetto XmlSerializer. |
| XmlSerializationCollectionFixupCallback |
Delegato utilizzato dalla XmlSerializer classe per la deserializzazione di tipi di dati XML con codifica SOAP che eseguono il mapping a raccolte o enumerazioni. |
| XmlSerializationFixupCallback |
Delegato utilizzato dalla XmlSerializer classe per la deserializzazione dei dati XML con codifica SOAP. |
| XmlSerializationReadCallback |
Delegato usato dalla XmlSerializer classe per la deserializzazione di tipi da dati XML non radice codificati con SOAP. |
| XmlSerializationWriteCallback |
Delegato utilizzato dalla classe per la XmlSerializer serializzazione di tipi da dati XML non radice con codifica SOAP. |
Commenti
La classe centrale nello spazio dei nomi è la XmlSerializer classe . Per utilizzare questa classe, utilizzare il XmlSerializer costruttore per creare un'istanza della classe utilizzando il tipo dell'oggetto da serializzare. Dopo aver creato un oggetto XmlSerializer , creare un'istanza dell'oggetto da serializzare. È inoltre necessario creare un oggetto per scrivere il file in un documento o in un flusso, ad esempio StreamTextWriter, o XmlWriter. È quindi possibile chiamare il Serialize metodo per convertire l'oggetto in un documento XML.
Per deserializzare un oggetto da un documento XML, creare un oggetto appropriato 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 dettagli come il nome effettivo dell'elemento XML usando la ElementName proprietà . Per un elenco completo di tutti gli attributi, vedere la panoramica della XmlSerializer classe.