DataContractSerializer Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Serializa e desserializa uma instância de um tipo em um fluxo XML ou em um documento usando um contrato de dados fornecido. Essa classe não pode ser herdada.
public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer- Herança
Comentários
Para obter mais informações sobre essa API, consulte Comentários da API complementar para DataContractSerializer.
Construtores
| DataContractSerializer(Type) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. |
| DataContractSerializer(Type, DataContractSerializerSettings) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo e das configurações especificadas. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especifico e uma coleção de tipos conhecidos que podem existir no grafo do objeto. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo e um substituto para a serialização personalizada. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para a serialização personalizada e uma alternativa para mapear declarações |
| DataContractSerializer(Type, String, String) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado usando o namespace e o elemento raiz XML fornecidos. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o elemento XML raiz e o namespace em dois parâmetros de cadeia de caracteres, bem como uma lista de tipos conhecidos que podem estar presentes no grafo do objeto. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para a serialização personalizada e o namespace e o elemento XML que contêm o conteúdo. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para a serialização personalizada, o elemento XML e o namespace que contêm o conteúdo e uma alternativa para mapear declarações |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado usando o namespace e o elemento raiz XML por meio de parâmetros do tipo XmlDictionaryString. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o elemento XML raiz e o namespace em dois parâmetros XmlDictionaryString, bem como uma lista de tipos conhecidos que podem estar presentes no grafo do objeto. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para a serialização personalizada e parâmetros do XmlDictionaryString que especificam o namespace e o elemento XML que contêm o conteúdo. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da classe DataContractSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo de objeto, o número máximo de itens de grafo a serem serializados, os parâmetros para ignorar dados inesperados, a decisão de usar ou não constructos XML não padrão para preservar os dados de referência do objeto no grafo, um substituto para a serialização personalizada, parâmetros desse XmlDictionaryString que especificam o elemento XML e o namespace que contêm o conteúdo e uma alternativa para mapear declarações |
Propriedades
| DataContractResolver |
Obtém o componente usado para mapear dinamicamente declarações |
| DataContractSurrogate |
Obtém um tipo substituto que pode ampliar o processo de serialização ou desserialização. |
| IgnoreExtensionDataObject |
Obtém um valor que especifica se deve ignorar os dados fornecidos por uma extensão da classe quando a classe está sendo serializada ou desserializada. |
| KnownTypes |
Obtém uma coleção de tipos que podem estar presentes no grafo de objeto serializado usando essa instância do DataContractSerializer. |
| MaxItemsInObjectGraph |
Obtém o número máximo de itens em um grafo de objeto a serem serializados ou desserializados. |
| PreserveObjectReferences |
Obtém um valor que especifica se constructos XML não padrão devem ser usados para preservar os dados de referência de objeto. |
| SerializeReadOnlyTypes |
Obtém um valor que especifica se tipos de somente leitura são serializados. |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsStartObject(XmlDictionaryReader) |
Determina se o XmlDictionaryReader está posicionado em um objeto que pode ser desserializado. |
| IsStartObject(XmlReader) |
Determina se o XmlReader está posicionado em um objeto que pode ser desserializado. |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| ReadObject(Stream) |
Lê o fluxo XML ou o documento com um Stream e retorna o objeto desserializado. (Herdado de XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader) |
Lê o documento ou o fluxo XML com um XmlDictionaryReader e retorna o objeto desserializado. (Herdado de XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean) |
Lê o fluxo XML com um XmlDictionaryReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor. |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
Lê um documento ou fluxo de documentos XML e retorna o objeto desserializado. O método inclui um parâmetro para especificar se o nome do objeto é verificado e validado e um resolvedor para mapear declarações |
| ReadObject(XmlReader) |
Lê o fluxo XML com um XmlReader e retorna o objeto desserializado. |
| ReadObject(XmlReader, Boolean) |
Lê o fluxo XML com um XmlReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| WriteEndObject(XmlDictionaryWriter) |
Grava o elemento XML de fechamento usando um XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Grava o elemento XML de fechamento usando um XmlWriter. |
| WriteObject(Stream, Object) |
Grava o conteúdo completo (início, conteúdo e final) do objeto no documento XML ou fluxo com o Stream especificado. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object) |
Grava o conteúdo completo (início, conteúdo e final) do objeto no documento XML ou fluxo com o XmlDictionaryWriter especificado. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
Grava todos os dados do objeto (elemento XML inicial, conteúdo e elemento delimitador) em um documento ou fluxo XML usando o XmlDictionaryWriter especificado. O método inclui um resolvedor para mapear declarações |
| WriteObject(XmlWriter, Object) |
Grava todos os dados de objeto (elemento XML de abertura, conteúdo e elemento XML de fechamento) em um documento ou fluxo XML com um XmlWriter. |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Grava o conteúdo de XML usando um XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Grava o conteúdo de XML usando um XmlWriter. |
| WriteStartObject(XmlDictionaryWriter, Object) |
Grava o elemento XML de abertura usando um XmlDictionaryWriter. |
| WriteStartObject(XmlWriter, Object) |
Grava o elemento XML de abertura usando um XmlWriter. |
Métodos de Extensão
| GetSerializationSurrogateProvider(DataContractSerializer) |
Retorna o provedor de serialização alternativo para esse serializador. |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
Especifica um provedor de serialização alternativo para esse DataContractSerializer. |
Aplica-se a
Acesso thread-safe
As instâncias dessa classe são thread-safe, exceto quando a instância é usada com uma implementação do IDataContractSurrogate ou DataContractResolver.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de