System.Runtime.Serialization Namespace

O namespace System.Runtime.Serialization contém classes que podem ser usadas para serialização e desserialização de objetos. The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects. A serialização é o processo de converter um objeto ou grafo de objetos em uma sequência linear de bytes para armazenamento ou transmissão para outro local. 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. Desserialização é o processo de pegar informações armazenadas e recriar objetos utilizando-as. Deserialization is the process of taking in stored information and recreating objects from it.

Classes

CollectionDataContractAttribute

Quando aplicado a um tipo de coleção, habilita a especificação personalizada dos elementos de item da coleção.When applied to a collection type, enables custom specification of the collection item elements. Esse atributo pode ser aplicado somente aos tipos reconhecidos pelo DataContractSerializer como coleções válidas e serializáveis.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Especifica os namespaces de CLR e XML do contrato de dados.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Especifica que o tipo define ou implementa um contrato de dados e são serializáveis por um serializador, como o DataContractSerializer.Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Para tornar seu tipo serializável, os autores de tipo devem definir um contrato de dados para seu tipo.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Fornece um mecanismo para mapear dinamicamente os tipos de e para representações de xsi:type durante a serialização e desserialização.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

Serializa e desserializa uma instância de um tipo em um fluxo XML ou em um documento usando um contrato de dados fornecido.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Essa classe não pode ser herdada.This class cannot be inherited.

DataContractSerializerExtensions

Estende a classe DataContractSerializer fornecendo métodos para definir e obter um ISerializationSurrogateProvider.Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Especifica as configurações do serializador de contrato de dados.Specifies data contract serializer settings.

DataMemberAttribute

Quando aplicado ao membro de um tipo, especifica que o membro faz parte de um contrato de dados e pode ser serializado por 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 as opções de formato de data e hora.Specifies date-time format options.

DeserializationBlockedException
EnumMemberAttribute

Especifica que o campo é um membro de enumeração e deve ser serializado.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Representa as opções que podem ser definidas para um XsdDataContractExporter.Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Armazena dados de um contrato de dados com controle de versão que foi estendido adicionando novos membros.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Fornece funcionalidade básica para formatadores de serialização de Common Language Runtime.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Representa uma implementação base da interface IFormatterConverter que usa a classe Convert e a interface IConvertible.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Fornece métodos estáticos para ajudar com a implementação de um Formatter para serialização.Provides static methods to aid with the implementation of a Formatter for serialization. Essa classe não pode ser herdada.This class cannot be inherited.

IgnoreDataMemberAttribute

Quando aplicado a membro de um tipo, especifica que o membro não faz parte de um contrato de dados e não é 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 as opções que podem ser definidas em um XsdDataContractImporter.Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

A exceção que é lançada quando DataContractSerializer ou NetDataContractSerializer encontram um contrato de dados inválido durante a serialização e a desserialização.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Especifica os tipos que devem ser reconhecidos pelo DataContractSerializer ao serializar ou desserializar um determinado tipo.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Serializa e desserializa uma instância de um tipo em um fluxo ou documento XML usando os tipos do .NET Framework fornecidos.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Essa classe não pode ser herdada.This class cannot be inherited.

ObjectIDGenerator

Gera IDs para objetos.Generates IDs for objects.

ObjectManager

Monitora a desserialização de objetos.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

Quando aplicado a um método, especifica que o método é chamado imediatamente após a desserialização de um objeto em um grafo de objeto.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. A ordem de desserialização em relação a outros objetos no gráfico é não determinística.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

Quando aplicado a um método, especifica que o método é chamado durante a desserialização de um objeto em um grafo de objeto.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. A ordem de desserialização em relação a outros objetos no gráfico é não determinística.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

Quando aplicado a um método, especifica que o método é chamado após a serialização de um objeto em um grafo de objeto.When applied to a method, specifies that the method is called after serialization of an object in an object graph. A ordem de serialização em relação a outros objetos no gráfico é não determinística.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

Quando aplicado a um método, especifica que o método é chamado durante a serialização de um objeto em um grafo de objeto.When applied to a method, specifies that the method is during serialization of an object in an object graph. A ordem de serialização em relação a outros objetos no gráfico é não determinística.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Especifica que um campo pode estar faltando em um fluxo de serialização para que BinaryFormatter e SoapFormatter não lancem uma exceção.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

Fornece dados para o evento de SerializeObjectState .Provides data for the SerializeObjectState event.

SerializationBinder

Permite aos usuários controlar o carregamento de classe e gerencia a classe a ser carregada.Allows users to control class loading and mandate what class to load.

SerializationException

A exceção é gerada quando ocorre um erro durante a serialização ou desserialização.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Armazena todos os dados necessários para serializar ou desserializar um objeto.Stores all the data needed to serialize or deserialize an object. Essa classe não pode ser herdada.This class cannot be inherited.

SerializationInfoEnumerator

Fornece um mecanismo de formatador amigável para analisar os dados em SerializationInfo.Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Essa classe não pode ser herdada.This class cannot be inherited.

SerializationObjectManager

Gerencia os processos de serialização em tempo de execução.Manages serialization processes at run time. Essa classe não pode ser herdada.This class cannot be inherited.

SurrogateSelector

Auxilia formatadores na seleção do substituto da serialização ao qual delegar o processo de serialização ou desserialização.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Fornece a classe base usada para serializar objetos como documentos ou fluxos XML.Provides the base class used to serialize objects as XML streams or documents. Esta classe é abstrata.This class is abstract.

XmlSerializableServices

Contém métodos para leitura e gravação de XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Quando recebe uma classe que representa um contrato de dados e metadados que representam um membro do contrato, produz uma consulta XPath para o 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

Possibilita a transformação de um conjunto de tipos do .NET Framework que são usadas em contratos de dados em um arquivo 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 a transformação de um conjunto de arquivos de esquema XML (.xsd) em tipos CLR (Common Language Runtime).Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Estruturas

SerializationEntry

Retém o valor, Type, e o nome de um objeto serializado.Holds the value, Type, and name of a serialized object.

StreamingContext

Descreve a origem e o destino de um determinado fluxo serializado e fornece um contexto adicional definido pelo chamador.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Interfaces

IDataContractSurrogate

Fornece os métodos necessários para substituir um tipo por outro no DataContractSerializer durante a serialização, desserialização e exportação e importação de documentos com 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 uma classe deverá ser notificada quando a desserialização do gráfico de objeto inteiro for concluída.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Observe que essa interface não é chamada durante a desserialização com o XmlSerializer (System.Xml.Serialization.XmlSerializer).Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Fornece uma estrutura de dados para armazenar dados extra encontrados pelo XmlObjectSerializer durante a desserialização de um tipo marcado com o 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

Fornece a funcionalidade para formatação de objetos serializados.Provides functionality for formatting serialized objects.

IFormatterConverter

Fornece a conexão entre uma instância de SerializationInfo e a classe fornecida pelo formatador mais adequada para analisar os dados dentro do 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 o implementador da interface atual é uma referência a outro objeto.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Habilita a serialização de dados de exceção personalizada no código de transparência de segurança.Enables serialization of custom exception data in security-transparent code.

ISerializable

Permite que um objeto controle sua própria serialização e desserialização.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implementa um seletor de substitutos de serialização que permite que um objeto realize a serialização e a desserialização de outro.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Fornece os métodos necessários para construir um substituto de serialização que estende o DataContractSerializer.Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Um substituto de serialização é usado durante a serialização e a desserialização para substituir um tipo por outro.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Indica uma classe de seletor alternativo de serialização.Indicates a serialization surrogate selector class.

Enumerações

EmitTypeInformation

Especifica a frequência de emissão das informações de tipo.Specifies how often to emit type information.

StreamingContextStates

Define um conjunto de sinalizadores que especifica o contexto de origem ou de destino para o fluxo durante a serialização.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Comentários

O ISerializable interface fornece uma maneira para classes controlar seu próprio comportamento de serialização.The ISerializable interface provides a way for classes to control their own serialization behavior. As classes de System.Runtime.Serialization.Formatters namespace controlam a formatação real de vários tipos de dados encapsulados em objetos serializados.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

Formatadores que serializam e desserializam os objetos de e para um determinado formato podem ser encontradas no System.Runtime.Serialization.Formatters namespace.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.