DataContractJsonSerializer Classe

Definição

Namespace:: System.Runtime.Serialization.Json

Assemblies:: System.Runtime.Serialization.dll, System.Runtime.Serialization.Json.dll

Assembly:: System.ServiceModel.Web.dll

Assembly:: System.Runtime.Serialization.dll

Assembly:: netstandard.dll

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 objetos para a JSON (JavaScript Object Notation) e desserializa 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: Object
DataContractJsonSerializer

Herança: Object

XmlObjectSerializer
DataContractJsonSerializer

Comentários

Para a maioria dos cenários que envolvem serialização para JSON e desserialização do 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 nomeado 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 posteriormente ser desserializado 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

Nome	Description
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto das configurações de tipo e serializador especificados.
DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)	Inicializa uma nova instância da DataContractJsonSerializer 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 ou desserializados, se devem ignorar dados inesperados ou emitir informações de tipo e um substituto para serialização personalizada.
DataContractJsonSerializer(Type, IEnumerable<Type>)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto do tipo especificado, com uma coleção de tipos conhecidos que podem estar presentes no grafo do objeto.
DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o nome 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 a serem serializados ou desserializados, se devem ignorar dados inesperados ou emitir informações de tipo e um substituto para serialização personalizada.
DataContractJsonSerializer(Type, String, IEnumerable<Type>)	Inicializa uma nova instância da DataContractJsonSerializer classe 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 podem estar presentes no grafo de objeto.
DataContractJsonSerializer(Type, String)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto de um tipo especificado usando o elemento raiz XML especificado por um parâmetro.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto do tipo especificado. Esse método também especifica o nome 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 a serem serializados ou desserializados, se devem ignorar dados inesperados ou emitir informações de tipo e um substituto para serialização personalizada.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)	Inicializa uma nova instância da DataContractJsonSerializer classe 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 podem estar presentes no grafo do objeto.
DataContractJsonSerializer(Type, XmlDictionaryString)	Inicializa uma nova instância da DataContractJsonSerializer classe 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)	Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto do tipo especificado.

Propriedades

Nome	Description
DataContractSurrogate	Obtém um tipo alternativo que está atualmente ativo para uma determinada IDataContractSurrogate instância. Os substitutos podem estender o processo de serialização ou desserialização.
DateTimeFormat	Obtém o formato dos itens de tipo de data e hora no grafo de 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 dados desconhecidos são ignorados na desserialização e se a IExtensibleDataObject interface é 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 os tipos somente leitura devem ser serializados.
UseSimpleDictionaryFormat	Obtém um valor que especifica se um formato de dicionário simples deve ser usado.

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)	Obtém um valor que especifica se o XmlDictionaryReader elemento É posicionado sobre um elemento XML que representa um objeto do qual o serializador pode desserializar.
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ê um fluxo de documentos no formato JSON (JavaScript Object Notation) e retorna o objeto desserializado.
ReadObject(XmlDictionaryReader, Boolean)	Lê o documento XML mapeado de JSON com um XmlDictionaryReader e retorna o objeto desserializado; ele também permite especificar se o serializador deve verificar se ele está posicionado em um elemento apropriado antes de tentar desserializar.
ReadObject(XmlDictionaryReader)	Lê o documento XML mapeado de JSON (JavaScript Object Notation) com um XmlDictionaryReader e retorna o objeto desserializado.
ReadObject(XmlReader, Boolean)	Lê um documento XML mapeado de JSON com um XmlReader e retorna o objeto desserializado; ele também permite especificar se o serializador deve verificar se ele está posicionado em um elemento apropriado antes de tentar desserializar.
ReadObject(XmlReader)	Lê o documento XML mapeado de JSON (JavaScript Object Notation) 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 em um documento XML usando um XmlDictionaryWriter, que pode ser mapeado para JSON (JavaScript Object Notation).
WriteEndObject(XmlWriter)	Grava o elemento XML de fechamento em um documento XML usando um XmlWriter, que pode ser mapeado para JSON (JavaScript Object Notation).
WriteObject(Stream, Object)	Serializa um objeto especificado para 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 JSON (JavaScript Object Notation). Grava todos os dados do 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 JSON (JavaScript Object Notation). Grava todos os dados do 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 em 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 em XML que pode ser mapeado para JSON (JavaScript Object Notation) usando um XmlWriter.

Aplica-se a

Comentários

Esta página foi útil?