Compartilhar via


DataContractJsonSerializer Classe

Definição

Serializa objetos para o objeto JSON (JavaScript Object Notation) e desserializa os dados JSON em objetos. Essa classe não pode ser herdada.

public ref class DataContractJsonSerializer sealed
public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
type DataContractJsonSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
Herança
DataContractJsonSerializer
Herança
DataContractJsonSerializer

Comentários

Para a maioria dos cenários que envolvem serialização para JSON e desserialização de JSON, recomendamos as APIs no namespace System.Text.Json.

Se o cenário exigir a DataContractJsonSerializer classe , você poderá usá-la para serializar instâncias de um tipo em um documento JSON e desserializar um documento JSON em uma instância de um tipo. Por exemplo, você pode criar um tipo chamado Person com propriedades que contêm dados essenciais, como um nome e um endereço. Em seguida, você pode criar e manipular uma instância da Person classe e gravar todos os seus valores de propriedade em um documento JSON para recuperação posterior. Este documento JSON pode ser desserializado posteriormente na Person classe ou em outra classe com um contrato de dados equivalente.

Se ocorrer um erro durante a serialização de uma resposta de saída no servidor ou a operação de resposta gerar uma exceção por algum outro motivo, ele poderá não ser retornado ao cliente como uma falha.

Construtores

DataContractJsonSerializer(Type)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto do tipo especificado.

DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto do tipo e das configurações do serializador especificadas.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto do tipo especifico, com uma coleção de tipos conhecidos que podem existir no grafo do objeto.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Inicializa uma nova instância da classe DataContractJsonSerializer 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 do objeto, o número máximo de itens de grafo para serializar ou desserializar, se deve ignorar dados inesperados ou emitir informações de tipo e um substituto para a serialização personalizada.

DataContractJsonSerializer(Type, String)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto de um tipo especificado usando o elemento raiz XML especificado por um parâmetro.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto de um tipo especificado usando o elemento raiz XML especificado por um parâmetro, com uma coleção de tipos conhecidos que pode estar presente no grafo do objeto.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o nome da raiz do elemento XML, uma lista de tipos conhecidos que podem estar presentes no grafo do objeto, o número máximo de itens de grafo para serializar ou desserializar, se deve ignorar dados inesperados ou emitir informações de tipo e um substituto para a serialização personalizada.

DataContractJsonSerializer(Type, XmlDictionaryString)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto de um tipo especificado usando o elemento raiz XML especificado por um parâmetro do tipo XmlDictionaryString.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto de um tipo especificado usando o elemento raiz XML especificado por um parâmetro de tipo XmlDictionaryString, com uma coleção de tipos conhecidos que pode estar presente no grafo do objeto.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Inicializa uma nova instância da classe DataContractJsonSerializer para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o nome da raiz do elemento XML, uma lista de tipos conhecidos que podem estar presentes no grafo do objeto, o número máximo de itens de grafo para serializar ou desserializar, se deve ignorar dados inesperados ou emitir informações de tipo e um substituto para a serialização personalizada.

Propriedades

DataContractSurrogate

Obtém um tipo substituto que está ativo no momento para uma determinada instância IDataContractSurrogate. Substitutos podem ampliar o processo de serialização ou desserialização.

DateTimeFormat

Obtém o formato dos itens do tipo data e hora no grafo do objeto.

EmitTypeInformation

Obtém ou define as configurações do serializador JSON do contrato de dados para emitir informações de tipo.

IgnoreExtensionDataObject

Obtém um valor que especifica se os dados desconhecidos serão ignorados na desserialização e se a interface IExtensibleDataObject é ignorada na serialização.

KnownTypes

Obtém uma coleção de tipos que podem estar presentes no grafo de objeto serializado usando essa instância do DataContractJsonSerializer.

MaxItemsInObjectGraph

Obtém o número máximo de itens em um grafo de objeto que o serializador serializa ou desserializa em uma chamada de leitura ou gravação.

SerializeReadOnlyTypes

Obtém ou define um valor que especifica se deve serializar os tipos somente leitura.

UseSimpleDictionaryFormat

Obtém um valor que especifica se um formato de dicionário simples deve ser usado.

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)
GetSerializationSurrogateProvider()

Serializa objetos para o objeto JSON (JavaScript Object Notation) e desserializa os dados JSON em objetos. Essa classe não pode ser herdada.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsStartObject(XmlDictionaryReader)

Obtém um valor que especifica se o XmlDictionaryReader está posicionado sobre um elemento XML que representa um objeto do qual o serializador pode desserializar.

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ê um fluxo de documento no formato JSON (JavaScript Object Notation) e retorna o objeto desserializado.

ReadObject(XmlDictionaryReader)

Lê o documento XML mapeado do JSON (JavaScript Object Notation) com um XmlDictionaryReader e retorna o objeto desserializado.

ReadObject(XmlDictionaryReader, Boolean)

Lê o documento XML mapeado do JSON com um XmlDictionaryReader e retorna o objeto desserializado. Ele também permite que você especifique se o serializador deve verificar se ele está posicionado em um elemento apropriado antes de tentar desserializar.

ReadObject(XmlReader)

Lê o documento XML mapeado do JSON (JavaScript Object Notation) com um XmlReader e retorna o objeto desserializado.

ReadObject(XmlReader, Boolean)

Lê um documento XML mapeado do JSON com um XmlReader e retorna o objeto desserializado. Ele também permite que você especifique se o serializador deve verificar se ele está posicionado em um elemento apropriado antes de tentar desserializar.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Serializa objetos para o objeto JSON (JavaScript Object Notation) e desserializa os dados JSON em objetos. Essa classe não pode ser herdada.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
WriteEndObject(XmlDictionaryWriter)

Grava o elemento XML de fechamento em um documento XML, usando um XmlDictionaryWriter, que pode ser mapeado para o JSON (JavaScript Object Notation).

WriteEndObject(XmlWriter)

Grava o elemento XML de fechamento em um documento XML, usando um XmlWriter, que pode ser mapeado para o JSON (JavaScript Object Notation).

WriteObject(Stream, Object)

Serializa um objeto especificado em dados JSON (JavaScript Object Notation) e grava o JSON resultante em um fluxo.

WriteObject(XmlDictionaryWriter, Object)

Serializa um objeto para XML que pode ser mapeado para o JSON (JavaScript Object Notation). Grava todos os dados de objeto, incluindo o elemento XML inicial, o conteúdo e o elemento de fechamento com um XmlDictionaryWriter.

WriteObject(XmlWriter, Object)

Serializa um objeto para XML que pode ser mapeado para o JSON (JavaScript Object Notation). Grava todos os dados de objeto, incluindo o elemento XML inicial, o conteúdo e o elemento de fechamento com um XmlWriter.

WriteObjectContent(XmlDictionaryWriter, Object)

Grava o conteúdo XML que pode ser mapeado para JSON (JavaScript Object Notation) usando um XmlDictionaryWriter.

WriteObjectContent(XmlWriter, Object)

Grava o conteúdo XML que pode ser mapeado para JSON (JavaScript Object Notation) usando um XmlWriter.

WriteStartObject(XmlDictionaryWriter, Object)

Grava o elemento XML de abertura para serializar um objeto para XML que pode ser mapeado para JSON (JavaScript Object Notation) usando um XmlDictionaryWriter.

WriteStartObject(XmlWriter, Object)

Grava o elemento XML de abertura para serializar um objeto para XML que pode ser mapeado para JSON (JavaScript Object Notation) usando um XmlWriter.

Aplica-se a