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 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 Suplementar para DataContractSerializer.
Construtores
| Nome | Description |
|---|---|
| DataContractSerializer(Type, DataContractSerializerSettings) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo e das configurações especificados. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar constructos XML não padrão para preservar dados de referência de objeto no grafo, um substituto para serialização personalizada e uma alternativa para mapear |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar constructos XML não padrão para preservar dados de referência de objeto no grafo e um substituto para serialização personalizada. |
| DataContractSerializer(Type, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado e uma coleção de tipos conhecidos que podem estar presentes no grafo de objeto. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar constructos XML não padrão para preservar dados de referência de objeto no grafo, um substituto para serialização personalizada, o elemento XML e o namespace que contém o conteúdo, e uma alternativa para mapear |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar constructos XML não padrão para preservar dados de referência de objeto no grafo, um substituto para serialização personalizada e o elemento XML e o namespace que contêm o conteúdo. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe 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) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado usando o elemento raiz XML fornecido e o namespace. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar construções XML não padrão para preservar dados de referência de objeto no grafo, um substituto para serialização personalizada, parâmetros que XmlDictionaryString especificam o elemento XML e o namespace que contém o conteúdo, e uma alternativa para mapear |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializa uma nova instância da DataContractSerializer classe 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, parâmetros para ignorar dados inesperados, se devem usar constructos XML não padrão para preservar dados de referência de objeto no grafo, um substituto para serialização personalizada e parâmetros que XmlDictionaryString especificam o elemento XML e o namespace que contêm o conteúdo. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o elemento XML raiz e o namespace em dois XmlDictionaryString parâmetros, bem como uma lista de tipos conhecidos que podem estar presentes no grafo do objeto. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado usando o elemento raiz XML e o namespace especificados por meio dos parâmetros do tipo XmlDictionaryString. |
| DataContractSerializer(Type) |
Inicializa uma nova instância da DataContractSerializer classe para serializar ou desserializar um objeto do tipo especificado. |
Propriedades
| Nome | Description |
|---|---|
| DataContractResolver |
Obtém o componente usado para mapear |
| DataContractSurrogate |
Obtém um tipo alternativo que pode estender o processo de serialização ou desserialização. |
| IgnoreExtensionDataObject |
Obtém um valor que especifica se os dados fornecidos por uma extensão da classe devem ser ignorados 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 para serializar ou desserializar. |
| PreserveObjectReferences |
Obtém um valor que especifica se os constructos XML não padrão devem ser usados para preservar dados de referência de objeto. |
| SerializeReadOnlyTypes |
Obtém um valor que especifica se os tipos somente leitura são serializados. |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsStartObject(XmlDictionaryReader) |
Determina se o XmlDictionaryReader objeto está posicionado em um objeto que pode ser desserializado. |
| IsStartObject(XmlReader) |
Determina se o XmlReader objeto está posicionado em um objeto que pode ser desserializado. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (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, Boolean, DataContractResolver) |
Lê um documento XML ou fluxo de documentos e retorna o objeto desserializado. O método inclui um parâmetro para especificar se o nome do objeto é verificado é validado e um resolvedor para declarações de mapeamento |
| ReadObject(XmlDictionaryReader, Boolean) |
Lê o fluxo XML com um XmlDictionaryReader objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor. |
| ReadObject(XmlDictionaryReader) |
Lê o documento XML ou o fluxo com um XmlDictionaryReader e retorna o objeto desserializado. (Herdado de XmlObjectSerializer) |
| ReadObject(XmlReader, Boolean) |
Lê o fluxo XML com um XmlReader objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor. |
| ReadObject(XmlReader) |
Lê o fluxo XML com um XmlReader e retorna o objeto desserializado. |
| 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 término) do objeto no documento XML ou no fluxo com o especificado Stream. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
Grava todos os dados do objeto (elemento XML inicial, conteúdo e elemento delimitador) em um documento XML ou fluxo usando o XmlDictionaryWriter especificado. O método inclui um resolvedor para declarações de mapeamento |
| WriteObject(XmlDictionaryWriter, Object) |
Grava o conteúdo completo (início, conteúdo e término) do objeto no documento XML ou no fluxo com o especificado XmlDictionaryWriter. (Herdado de XmlObjectSerializer) |
| WriteObject(XmlWriter, Object) |
Grava todos os dados do objeto (elemento XML inicial, conteúdo e elemento de fechamento) em um documento XML ou fluxo com um XmlWriter. |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Grava o conteúdo XML usando um XmlDictionaryWriter. |
| WriteObjectContent(XmlWriter, Object) |
Grava o conteúdo 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
| Nome | Description |
|---|---|
| GetSerializationSurrogateProvider(DataContractSerializer) |
Retorna o provedor de serialização substituto para esse serializador. |
| SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider) |
Especifica um provedor de serialização alternativo para isso 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.