DataContractJsonSerializer Classe

Definição

Espaço de Nomes:
System.Runtime.Serialization.Json
Assemblagens:
System.Runtime.Serialization.dll, System.Runtime.Serialization.Json.dll
Assemblagem:
System.ServiceModel.Web.dll
Assemblagem:
System.Runtime.Serialization.dll
Assemblagem:
netstandard.dll

Serializa objetos para a JavaScript Object Notation (JSON) e desserializa os dados JSON para objetos. Esta 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

Observações

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

Se o teu cenário exigir a DataContractJsonSerializer classe, podes usá-la para serializar instâncias de um tipo num documento JSON e para desserializar um documento JSON numa 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 endereço. Depois podes criar e manipular uma instância da Person classe e escrever todos os seus valores de propriedade num documento JSON para recuperação posterior. Este documento JSON pode posteriormente ser desserializado para a Person classe ou 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 se a operação de resposta lançar uma exceção por algum outro motivo, pode não ser devolvido ao cliente como falha.

Construtores

Name Description
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Inicializa uma nova instância da DataContractJsonSerializer classe para serializar ou desserializar um objeto do tipo especificado e das definições do serializador.
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. Este método também especifica uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de itens do grafo a serializar ou desserializar, se deve ignorar dados inesperados ou emitir informação do 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 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. Este método também especifica o nome raiz do elemento XML, uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de elementos do grafo a serializar ou desserializar, se deve ignorar dados inesperados ou emitir informação do 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 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. Este método também especifica o nome raiz do elemento XML, uma lista de tipos conhecidos que podem estar presentes no grafo-objeto, o número máximo de elementos do grafo a serializar ou desserializar, se deve ignorar dados inesperados ou emitir informação do 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 do tipo XmlDictionaryString, com uma coleção de tipos conhecidos que podem estar presentes no grafo 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

Name Description
DataContractSurrogate

Recebe um tipo de substituição que está ativo para uma dada IDataContractSurrogate instância. Os substitutos podem prolongar o processo de serialização ou desserialização.
DateTimeFormat

Obtém o formato dos itens do tipo data e hora no gráfico de objetos.
EmitTypeInformation

Obtém ou define as definições do serializador JSON do contrato de dados para emitir informação 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-objeto serializado usando esta instância do DataContractJsonSerializer.
MaxItemsInObjectGraph

Obtém o número máximo de itens num grafo objeto que o serializador serializa ou desserializa numa chamada de leitura ou escrita.
SerializeReadOnlyTypes

Recebe ou define um valor que especifica se deve serializar tipos apenas de leitura.
UseSimpleDictionaryFormat

Recebe um valor que especifica se deve usar um formato simples de dicionário.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de 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 está posicionado sobre um elemento XML que representa um objeto a partir do qual o serializador pode desserializar.
IsStartObject(XmlReader)

Determina se o XmlReader está posicionado num objeto que pode ser desserializado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ReadObject(Stream)

Lê um fluxo de documento no formato JSON (JavaScript Object Notation) e devolve o objeto desserializado.
ReadObject(XmlDictionaryReader, Boolean)

Lê o documento XML mapeado a partir de JSON com um XmlDictionaryReader e devolve o objeto desserializado; também permite especificar se o serializador deve verificar se está posicionado num elemento apropriado antes de tentar desserializar.
ReadObject(XmlDictionaryReader)

Lê o documento XML mapeado a partir de JSON (JavaScript Object Notation) com um XmlDictionaryReader e devolve o objeto deserializado.
ReadObject(XmlReader, Boolean)

Lê um documento XML mapeado a partir de JSON com um XmlReader e devolve o objeto desserializado; também permite especificar se o serializador deve verificar se está posicionado num elemento apropriado antes de tentar desserializar.
ReadObject(XmlReader)

Lê o documento XML mapeado a partir de JSON (JavaScript Object Notation) com um XmlReader e devolve o objeto deserializado.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
WriteEndObject(XmlDictionaryWriter)

Escreve o elemento XML de encerramento num documento XML, usando um XmlDictionaryWriter, que pode ser mapeado para JavaScript Object Notation (JSON).
WriteEndObject(XmlWriter)

Escreve o elemento XML de encerramento num documento XML, usando um XmlWriter, que pode ser mapeado para JavaScript Object Notation (JSON).
WriteObject(Stream, Object)

Serializa um objeto especificado para dados JavaScript Object Notation (JSON) e escreve o JSON resultante num fluxo.
WriteObject(XmlDictionaryWriter, Object)

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

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

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

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

Escreve o elemento XML de abertura para serializar um objeto em XML que pode ser mapeado para JavaScript Object Notation (JSON) usando um XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)

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

Aplica-se a