System.Runtime.Serialization Espacio de nombres

El espacio de nombres System.Runtime.Serialization contiene clases que se pueden utilizar para serializar y deserializar objetos. The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects. La serialización es el proceso de convertir un objeto o un gráfico de objetos en una secuencia lineal de bytes para su almacenamiento o transmisión a otra ubicación. 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 deserialización es el proceso mediante el cual se recoge la información almacenada y se vuelven a crear objetos a partir de la misma. Deserialization is the process of taking in stored information and recreating objects from it.

Clases

CollectionDataContractAttribute

Cuando se aplica a un tipo de colección, habilita la especificación personalizada de los elementos de elemento de colección.When applied to a collection type, enables custom specification of the collection item elements. Este atributo sólo se puede aplicar a los tipos que son reconocidos por DataContractSerializer como colecciones válidas serializables.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Especifica el espacio de nombres CLR y el espacio de nombres XML del contrato de datos.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Especifica que el tipo define o implementa un contrato de datos y los puede serializar un serializador como, por ejemplo DataContractSerializer.Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Para que hacer su tipo sea serializable, los autores del tipo deben definir un contrato de datos para dicho tipo.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Proporciona un mecanismo para asignar dinámicamente los tipos entre las representaciones xsi:type durante la serialización y la deserialización.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

Serializa y deserializa una instancia de un tipo en un flujo o en un documento XML utilizando un contrato de datos proporcionado.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Esta clase no puede heredarse.This class cannot be inherited.

DataContractSerializerExtensions

Extiende la clase DataContractSerializer mediante la proporción de métodos para establecer y obtener ISerializationSurrogateProvider.Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Especifica la configuración del serializador de contrato de datos.Specifies data contract serializer settings.

DataMemberAttribute

Cuando se aplica al miembro de un tipo, especifica que el miembro forma parte de un contrato de datos y lo puede serializar 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

Especifica las opciones de formato de fecha y hora.Specifies date-time format options.

EnumMemberAttribute

Especifica que el campo es un miembro de enumeración y se debe serializar.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Representa las opciones que se pueden establecer para XsdDataContractExporter.Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Almacena los datos de un contrato de datos con control de versiones que se ha ampliado agregando nuevos miembros.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Proporciona funcionalidad básica para los formateadores de serialización de Common Language Runtime.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Representa una implementación básica de la interfaz IFormatterConverter que utiliza la clase Convert y la interfaz IConvertible.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Proporciona métodos estáticos para ayudar a la implementación de un objeto Formatter para la serialización.Provides static methods to aid with the implementation of a Formatter for serialization. Esta clase no puede heredarse.This class cannot be inherited.

IgnoreDataMemberAttribute

Cuando se aplica al miembro de un tipo, especifica que el miembro no forma parte de un contrato de datos y no está serializado.When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.

ImportOptions

Representa las opciones que se pueden establecer en XsdDataContractImporter.Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

La excepción que se inicia cuando DataContractSerializer o NetDataContractSerializer detecta un contrato de datos no válido durante la serialización y deserialización.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Especifica tipos que deberá reconocer DataContractSerializer al serializar o deserializar un tipo determinado.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Serializa y deserializa una instancia de un tipo en secuencia XML o en documento utilizando los tipos de .NET Framework proporcionados.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Esta clase no puede heredarse.This class cannot be inherited.

ObjectIDGenerator

Genera identificadores para los objetos.Generates IDs for objects.

ObjectManager

Realiza el seguimiento de los objetos a medida que se deserializan.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

Cuando se aplica a un método, especifica que se produce una llamada al método inmediatamente después de la deserialización de un objeto en un gráfico de objetos.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. El orden de la deserialización en relación con otros objetos del gráfico no es determinístico.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

Cuando se aplica a un método, especifica que se llama al método durante la deserialización de un objeto de un gráfico de objetos.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. El orden de la deserialización en relación con otros objetos del gráfico no es determinístico.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

Cuando se aplica a un método, especifica que se llama al método después de la serialización de un objeto de un gráfico de objetos.When applied to a method, specifies that the method is called after serialization of an object in an object graph. El orden de serialización en relación con otros objetos del gráfico no es determinístico.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

Cuando se aplica a un método, especifica que el método está durante la serialización de un objeto de un gráfico de objetos.When applied to a method, specifies that the method is during serialization of an object in an object graph. El orden de serialización en relación con otros objetos del gráfico no es determinístico.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Especifica que podría faltar un campo de una secuencia de serialización para que BinaryFormatter y SoapFormatter no produzcan una excepción.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

Proporciona datos para el evento SerializeObjectState.Provides data for the SerializeObjectState event.

SerializationBinder

Permite a los usuarios controlar la carga de clases y encargar qué clase se debe cargar.Allows users to control class loading and mandate what class to load.

SerializationException

Excepción que se produce cuando se produce un error durante la serialización o deserialización.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Almacena todos los datos necesarios para serializar o deserializar un objeto.Stores all the data needed to serialize or deserialize an object. Esta clase no puede heredarse.This class cannot be inherited.

SerializationInfoEnumerator

Proporciona un mecanismo compatible con el formateador para analizar los datos de SerializationInfo.Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Esta clase no puede heredarse.This class cannot be inherited.

SerializationObjectManager

Administra en tiempo de ejecución los procesos de serialización.Manages serialization processes at run time. Esta clase no puede heredarse.This class cannot be inherited.

SurrogateSelector

Ayuda a los formateadores en la selección de los suplentes de serialización en los que se puede delegar el proceso de serialización o de deserialización.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Proporciona la clase base usada para serializar objetos como secuencias XML o documentos.Provides the base class used to serialize objects as XML streams or documents. Esta clase es abstracta.This class is abstract.

XmlSerializableServices

Contiene los métodos para leer y escribir XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Cuando se da una clase que representa un contrato de datos y metadatos que representan un miembro del contrato, se produce una consulta XPath para el miembro.When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

XsdDataContractExporter

Permite la transformación de un conjunto de tipos de .NET Framework que se usan en contratos de datos en un archivo de esquema XML (.xsd).Allows the transformation of a set of .NET Framework types that are used in data contracts into an XML schema file (.xsd).

XsdDataContractImporter

Permite la transformación de un conjunto de archivos de esquema XML (.xsd) en los tipos de Common Language Runtime (CLR).Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Estructuras

SerializationEntry

Guarda el valor, Type y nombre de un objeto serializado.Holds the value, Type, and name of a serialized object.

StreamingContext

Describe el origen y destino de una secuencia de serialización determinada y proporciona un contexto definido por el llamador adicional.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Interfaces

IDataContractSurrogate

Proporciona los métodos necesarios para sustituir un tipo por otro mediante DataContractSerializer durante la serialización, la deserialización y la exportación e importación de documentos de esquema XML (XSD).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 que una clase debe recibir una notificación cuando ha finalizado la deserialización de todo el gráfico de objetos.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Observe que no se llama a esta interfaz al deserializar con el XmlSerializer (System.Xml.Serialization.XmlSerializer).Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Proporciona una estructura de datos para almacenar datos adicionales detectados por XmlObjectSerializer durante la deserialización de un tipo marcada con el atributo DataContractAttribute.Provides a data structure to store extra data encountered by the XmlObjectSerializer during deserialization of a type marked with the DataContractAttribute attribute.

IFormatter

Proporciona funcionalidad para aplicar formato a los objetos serializados.Provides functionality for formatting serialized objects.

IFormatterConverter

Proporciona una conexión entre una instancia de SerializationInfo y la clase proporcionada por el formateador más adecuada para analizar los datos que contiene 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 que el implementador de la interfaz actual es una referencia a otro objeto.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Habilita la serialización de datos de excepción personalizados en código transparente en seguridad.Enables serialization of custom exception data in security-transparent code.

ISerializable

Permite que un objeto controle su propia serialización y deserialización.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implementa un selector de suplentes de serialización que permite que un objeto realice la serialización y deserialización de otro objeto.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Proporciona los métodos necesarios para construir un suplente de serialización que extiende DataContractSerializer.Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Se usa un suplente de serialización durante la serialización y deserialización para substituir un tipo por otro.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Indica una clase de selectores de suplentes de serialización.Indicates a serialization surrogate selector class.

Enumeraciones

EmitTypeInformation

Especifica la frecuencia para emitir información de tipo.Specifies how often to emit type information.

StreamingContextStates

Define un conjunto de indicadores que especifica el contexto de origen o destino para el flujo durante la serialización.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Comentarios

La interfaz ISerializable proporciona la manera en que las clases pueden controlar su propio comportamiento de serialización.The ISerializable interface provides a way for classes to control their own serialization behavior. Las clases en el System.Runtime.Serialization.Formatters espacio de nombres controlan el formato real de varios tipos de datos encapsulados en los objetos serializados.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

Formateadores de serializar y deserializan objetos hacia y desde un formato determinado pueden encontrarse en el System.Runtime.Serialization.Formatters espacio de nombres.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.