System.Runtime.Serialization Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Contém classes que podem ser usadas para serializar e desserializar objetos. A serialização é o processo de converter um objeto ou um grafo de objetos numa sequência linear de bytes para armazenamento ou transmissão para outro local. A desserialização é o processo de absorver informação armazenada e recriar objetos a partir dela.
Classes
| Name | Description |
|---|---|
| CollectionDataContractAttribute |
Quando aplicado a um tipo de coleção, permite a especificação personalizada dos elementos do item da coleção. Este atributo pode ser aplicado apenas a tipos reconhecidos por coleções DataContractSerializer válidas e serializáveis. |
| ContractNamespaceAttribute |
Especifica o namespace CLR e o namespace XML do contrato de dados. |
| DataContractAttribute |
Especifica que o tipo define ou implementa um contrato de dados e é serializável por um serializador, como o DataContractSerializer. Para tornar o seu tipo serializável, os autores de tipos devem definir um contrato de dados para o seu tipo. |
| DataContractResolver |
Fornece um mecanismo para mapear dinamicamente tipos para e a partir |
| DataContractSerializer |
Serializa e desserializa uma instância de um tipo num fluxo ou documento XML usando um contrato de dados fornecido. Esta classe não pode ser herdada. |
| DataContractSerializerExtensions |
Estende a DataContractSerializer classe fornecendo métodos para definir e obter um ISerializationSurrogateProvider. |
| DataContractSerializerSettings |
Especifica as definições do serializador de contrato de dados. |
| DataMemberAttribute |
Quando aplicado ao membro de um tipo, especifica que o membro faz parte de um contrato de dados e é serializável pelo DataContractSerializer. |
| DateTimeFormat |
Especifica opções de formato data-hora. |
| EnumMemberAttribute |
Especifica que o campo é um membro de enumeração e deve ser serializado. |
| ExportOptions |
Representa as opções que podem ser definidas para um XsdDataContractExporter. |
| ExtensionDataObject |
Armazena dados de um contrato de dados versionado que foi alargado com a adição de novos membros. |
| Formatter |
Fornece funcionalidade base para os formatadores de serialização em tempo de execução da linguagem comum. |
| FormatterConverter |
Representa uma implementação base da IFormatterConverter interface que utiliza a Convert classe e a IConvertible interface. |
| FormatterServices |
Fornece métodos estáticos para ajudar na implementação de a Formatter para serialização. Esta classe não pode ser herdada. |
| IgnoreDataMemberAttribute |
Quando aplicado ao membro de um tipo, especifica que o membro não faz parte de um contrato de dados e não é serializado. |
| ImportOptions |
Representa as opções que podem ser definidas num XsdDataContractImporter. |
| InvalidDataContractException |
A exceção que é lançada quando o DataContractSerializer ou NetDataContractSerializer encontra um contrato de dados inválido durante a serialização e desserialização. |
| KnownTypeAttribute |
Especifica tipos que devem ser reconhecidos por o DataContractSerializer ao serializar ou desserializar um dado tipo. |
| NetDataContractSerializer |
Serializa e desserializa uma instância de um tipo em fluxo ou documento XML usando os tipos .NET fornecidos. Esta classe não pode ser herdada. |
| ObjectIDGenerator |
Gera IDs para objetos. |
| ObjectManager |
Mantém o registo dos objetos à medida que são desserializados. |
| OnDeserializedAttribute |
Quando aplicado a um método, especifica que o método é chamado imediatamente após a desserialização de um objeto num grafo de objetos. A ordem de desserialização relativa a outros objetos no grafo é não determinística. |
| OnDeserializingAttribute |
Quando aplicado a um método, especifica que o método é chamado durante a desserialização de um objeto num grafo de objetos. A ordem de desserialização relativa a outros objetos no grafo é não determinística. |
| OnSerializedAttribute |
Quando aplicado a um método, especifica que o método é chamado após a serialização de um objeto num grafo de objetos. A ordem de serialização relativa a outros objetos no grafo é não determinística. |
| OnSerializingAttribute |
Quando aplicado a um método, especifica que o método é chamado durante a serialização de um objeto num grafo de objetos. A ordem de serialização relativa a outros objetos no grafo é não determinística. |
| OptionalFieldAttribute |
Especifica que pode faltar um campo num fluxo de serialização, de modo que o BinaryFormatter e não SoapFormatter lança uma exceção. |
| SafeSerializationEventArgs |
Fornece dados para o SerializeObjectState evento. |
| SerializationBinder |
Permite aos utilizadores controlar o carregamento de classes e exigir qual classe carregar. |
| SerializationException |
A exceção lançada quando ocorre um erro durante a serialização ou desserialização. |
| SerializationInfo |
Armazena todos os dados necessários para serializar ou desserializar um objeto. Esta classe não pode ser herdada. |
| SerializationInfoEnumerator |
Fornece um mecanismo amigável para formatadores para analisar os dados em SerializationInfo. Esta classe não pode ser herdada. |
| SerializationObjectManager |
Gere os processos de serialização em tempo de execução. Esta classe não pode ser herdada. |
| SurrogateSelector |
Auxilia os formatter na seleção do substituto de serialização para delegar o processo de serialização ou desserialização. |
| XmlObjectSerializer |
Fornece a classe base usada para serializar objetos como fluxos XML ou documentos. Esta aula é abstrata. |
| XmlSerializableServices |
Contém métodos para ler e escrever 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. |
| XsdDataContractExporter |
Permite a transformação de um conjunto de tipos .NET usados em contratos de dados num ficheiro de esquema XML (.xsd). |
| XsdDataContractImporter |
Permite a transformação de um conjunto de ficheiros de esquema XML (.xsd) em tipos de execução de linguagem comum (CLR). |
Estruturas
| Name | Description |
|---|---|
| SerializationEntry |
Detém o valor, Type, e o nome de um objeto serializado. |
| StreamingContext |
Descreve a origem e o destino de um dado fluxo serializado e fornece um contexto adicional definido pelo chamador. |
Interfaces
| Name | Description |
|---|---|
| IDataContractSurrogate |
Fornece os métodos necessários para substituir um tipo por outro durante DataContractSerializer a serialização, desserialização e exportação e importação de documentos de esquema XML (XSD). |
| IDeserializationCallback |
Indica que uma classe deve ser notificada quando a desserialização de todo o grafo-objeto for concluída. Esta interface não é chamada quando se desserializa com XmlSerializer. |
| IExtensibleDataObject |
Fornece uma estrutura de dados para armazenar dados adicionais encontrados durante XmlObjectSerializer a desserialização de um tipo marcado com o DataContractAttribute atributo. |
| IFormatter |
Fornece funcionalidade para formatar objetos serializados. |
| IFormatterConverter |
Fornece a ligação entre uma instância de SerializationInfo e a classe fornecida pelo formatador mais adequada para analisar os dados dentro do SerializationInfo. |
| IObjectReference |
Indica que o implementador atual da interface é uma referência a outro objeto. |
| ISafeSerializationData |
Permite a serialização de dados de exceções personalizados em código transparente à segurança. |
| ISerializable |
Permite a um objeto controlar a sua própria serialização e desserialização através de serialização binária e XML. |
| ISerializationSurrogate |
Implementa um seletor de substituto de serialização que permite a um objeto realizar serialização e desserialização de outro. |
| ISerializationSurrogateProvider |
Fornece os métodos necessários para construir um substituto de serialização que estende o DataContractSerializer. Um substituto de serialização é usado durante a serialização e desserialização para substituir um tipo por outro. |
| ISurrogateSelector |
Indica uma classe de seletor substituta de serialização. |
Enumerações
| Name | Description |
|---|---|
| EmitTypeInformation |
Especifica com que frequência deve emitir informação do tipo. |
| StreamingContextStates |
Define um conjunto de flags que especifica o contexto de origem ou destino do fluxo durante a serialização. |
Observações
A ISerializable interface oferece uma forma para as classes controlarem o seu próprio comportamento de serialização. As classes no System.Runtime.Serialization.Formatters namespace controlam a formatação real de vários tipos de dados encapsulados nos objetos serializados.
Materiais que serializam e desserializam objetos para e a partir de um determinado formato podem ser encontrados no System.Runtime.Serialization.Formatters namespace.