System.Runtime.Serialization Namespace

Lo spazio dei nomi System.Runtime.Serialization contiene classi che è possibile utilizzare per la serializzazione e la deserializzazione di oggetti. The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects. La serializzazione è il processo di conversione di un oggetto o di un grafico di oggetti in una sequenza lineare di byte per l'archiviazione o la trasmissione a una posizione diversa. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. La deserializzazione è invece il processo di recupero delle informazioni archiviate e di creazione di oggetti da tali informazioni. Deserialization is the process of taking in stored information and recreating objects from it.

Classi

CollectionDataContractAttribute

Quando viene applicato a un tipo di raccolta, consente la specifica personalizzata degli elementi della raccolta.When applied to a collection type, enables custom specification of the collection item elements. Questo attributo può essere applicato soltanto ai tipi che sono riconosciuti come raccolte serializzabili valide dalla classe DataContractSerializer.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Specifica lo spazio dei nomi CLR e lo spazio dei nomi XML del contratto dati.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Specifica che il tipo definisce o implementa un contratto dati ed è serializzabile da un serializzatore, ad esempio la classe DataContractSerializer.Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Per rendere serializzabile il proprio tipo, gli autori del tipo devono definire un contratto dati per tale tipo.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Fornisce un meccanismo per il mapping dinamico di tipi a e da rappresentazioni xsi:type durante la serializzazione e la deserializzazione.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

Serializza e deserializza un'istanza di un tipo in un flusso o documento XML usando un contratto dati fornito.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Questa classe non può essere ereditata.This class cannot be inherited.

DataContractSerializerExtensions

Estende la classe DataContractSerializer specificando metodi per impostare e ottenere ISerializationSurrogateProvider.Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Specifica le impostazioni del serializzatore del contratto dati.Specifies data contract serializer settings.

DataMemberAttribute

Quando viene applicato al membro di un tipo, specifica che il membro fa parte di un contratto dati e può essere serializzato dalla classe DataContractSerializer.When applied to the member of a type, specifies that the member is part of a data contract and is serializable by the DataContractSerializer.

DateTimeFormat

Specifica le opzioni di formato di data e ora.Specifies date-time format options.

EnumMemberAttribute

Specifica che il campo è un membro di enumerazione e deve essere serializzato.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Rappresenta le opzioni che possono essere impostate per una classe XsdDataContractExporter.Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Archivia dati da un contratto dati con versione che è stato esteso mediante l'aggiunta di membri nuovi.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Fornisce la funzionalità di base per i formattatori di serializzazione Common Language Runtime.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Rappresenta un'implementazione di base dell'interfaccia IFormatterConverter che utilizza la classe Convert e l'interfaccia IConvertible.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Fornisce metodi statici per supportare l'implementazione di un oggetto Formatter per la serializzazione.Provides static methods to aid with the implementation of a Formatter for serialization. Questa classe non può essere ereditata.This class cannot be inherited.

IgnoreDataMemberAttribute

Se applicato al membro di un tipo, specifica che il membro non fa parte di un contratto dati e non è serializzato.When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.

ImportOptions

Rappresenta le opzioni che possono essere impostate in una classe XsdDataContractImporter.Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

Eccezione generata quando DataContractSerializer o NetDataContractSerializer rileva un contratto dati non valido durante la serializzazione e la deserializzazione.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Specifica i tipi che devono essere riconosciuti dalla classe DataContractSerializer durante la serializzazione o deserializzazione di un tipo specifico.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Serializza e deserializza un'istanza di un tipo in un flusso o documento XML usando i tipi .NET Framework forniti.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Questa classe non può essere ereditata.This class cannot be inherited.

ObjectIDGenerator

Genera ID per gli oggetti.Generates IDs for objects.

ObjectManager

Tiene traccia degli oggetti in fase di deserializzazione.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

Quando applicato a un metodo, specifica che il metodo viene chiamato immediatamente dopo la serializzazione di un oggetto in un oggetto grafico.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. L'ordine di deserializzazione rispetto ad altri oggetti nel grafico è non deterministico.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

Se applicato a un metodo, specifica che il metodo viene chiamato durante la deserializzazione di un oggetto in un oggetto grafico.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. L'ordine di deserializzazione rispetto ad altri oggetti nel grafico è non deterministico.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

Se applicato a un metodo, specifica che il metodo viene chiamato dopo la serializzazione di un oggetto in un oggetto grafico.When applied to a method, specifies that the method is called after serialization of an object in an object graph. L'ordine di serializzazione rispetto ad altri oggetti nel grafico è non deterministico.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

Se applicato a un metodo, specifica che il metodo viene chiamato durante la serializzazione di un oggetto in un oggetto grafico.When applied to a method, specifies that the method is during serialization of an object in an object graph. L'ordine di serializzazione rispetto ad altri oggetti nel grafico è non deterministico.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Specifica che un campo può non essere presente in un flusso di serializzazione in modo tale che gli oggetti BinaryFormatter e SoapFormatter non generino un'eccezione.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

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

SerializationBinder

Consente di controllare il caricamento delle classi e di indicare la classe da caricare.Allows users to control class loading and mandate what class to load.

SerializationException

Eccezione generata quando si verifica un errore durante la serializzazione o la deserializzazione.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Memorizza tutti i dati necessari per serializzare o deserializzare un oggetto.Stores all the data needed to serialize or deserialize an object. Questa classe non può essere ereditata.This class cannot be inherited.

SerializationInfoEnumerator

Fornisce un meccanismo riconosciuto dal formattatore per l'analisi dei dati in SerializationInfo.Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Questa classe non può essere ereditata.This class cannot be inherited.

SerializationObjectManager

Gestisce i processi di serializzazione in fase di esecuzione.Manages serialization processes at run time. Questa classe non può essere ereditata.This class cannot be inherited.

SurrogateSelector

Assiste i formattatori nella scelta del surrogato di serializzazione a cui delegare il processo di serializzazione o di deserializzazione.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Fornisce la classe di base utilizzata per serializzare oggetti come flussi o documenti XML.Provides the base class used to serialize objects as XML streams or documents. Questa classe è astratta.This class is abstract.

XmlSerializableServices

Contiene metodi per la lettura e la scrittura di dati XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Quando si specifica una classe che rappresenta un contratto dati e dei metadati che rappresentano un membro del contratto, viene prodotta una query XPath per il membro.When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

XsdDataContractExporter

Consente la trasformazione di un set di tipi .NET Framework usati in contratti dati in un file XML Schema (con estensione xsd).Allows the transformation of a set of .NET Framework types that are used in data contracts into an XML schema file (.xsd).

XsdDataContractImporter

Consente la trasformazione di un set di file di XML Schema (estensione xsd) in tipi CLR (Common Language Runtime).Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Struct

SerializationEntry

Contiene il valore, Type e il nome di un oggetto serializzato.Holds the value, Type, and name of a serialized object.

StreamingContext

Descrive l'origine e la destinazione di un flusso serializzato specificato e fornisce un ulteriore contesto definito dal chiamante.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Interfacce

IDataContractSurrogate

Fornisce i metodi necessari alla classe DataContractSerializer per sostituire un tipo con un altro durante la serializzazione, la deserializzazione, l'esportazione e l'importazione di documenti di XML Schema.Provides the methods needed to substitute one type for another by the DataContractSerializer during serialization, deserialization, and export and import of XML schema documents (XSD).

IDeserializationCallback

Indica che una classe deve essere notificata al termine della deserializzazione dell'intero grafico di oggetti.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Si noti che questa interfaccia non viene chiamata quando viene eseguita la deserializzazione con il serializzatore XmlSerializer (System.Xml.Serialization.XmlSerializer).Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Fornisce una struttura di dati in cui archiviare dati aggiuntivi rilevati da XmlObjectSerializer durante la deserializzazione di un tipo contrassegnato con l'attributo DataContractAttribute.Provides a data structure to store extra data encountered by the XmlObjectSerializer during deserialization of a type marked with the DataContractAttribute attribute.

IFormatter

Fornisce una funzionalità per la formattazione di oggetti serializzati.Provides functionality for formatting serialized objects.

IFormatterConverter

Fornisce il collegamento tra un'istanza di SerializationInfo e la classe fornita dal formattatore più appropriata per l'analisi dei dati inclusi in SerializationInfo.Provides the connection between an instance of SerializationInfo and the formatter-provided class best suited to parse the data inside the SerializationInfo.

IObjectReference

Indica che l'implementatore di interfacce corrente è un riferimento a un altro oggetto.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Abilita la serializzazione di dati dell'eccezione personalizzati in codice trasparente per la sicurezza.Enables serialization of custom exception data in security-transparent code.

ISerializable

Consente a un oggetto di controllare la propria serializzazione e deserializzazione.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implementa un selettore di surrogati di serializzazione che consente a un oggetto di eseguire la serializzazione e la deserializzazione di un altro oggetto.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Fornisce i metodi necessari per costruire un surrogato di serializzazione che estende DataContractSerializer.Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Un surrogato di serializzazione viene usato durante la serializzazione e la deserializzazione per sostituire un tipo con un altro.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Indica una classe di selettori di surrogati di serializzazione.Indicates a serialization surrogate selector class.

Enumerazioni

EmitTypeInformation

Specifica la frequenza di generazione delle informazioni sul tipo.Specifies how often to emit type information.

StreamingContextStates

Definisce un set di flag che specifica il contesto di origine o di destinazione per il flusso durante la serializzazione.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Commenti

L'interfaccia ISerializable consente alle classi di controllare il proprio comportamento di serializzazione.The ISerializable interface provides a way for classes to control their own serialization behavior. Le classi di System.Runtime.Serialization.Formatters dello spazio dei nomi di controllare la formattazione effettiva dei diversi tipi di dati incapsulati in oggetti serializzati.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

I formattatori che serializzare e deserializzano oggetti da e verso un formato particolare sono reperibile nella System.Runtime.Serialization.Formatters dello spazio dei nomi.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.