JsonSerializer.Deserialize Método

Referência

Definição

Namespace:: System.Text.Json

Assembly:: System.Text.Json.dll

Pacote:: System.Text.Json v8.0.3

Pacote:: System.Text.Json v9.0.0-preview.3.24172.9

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.

Sobrecargas

Deserialize(Stream, JsonTypeInfo)	Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`. O Stream será lido até a conclusão.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um `returnType`.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido e o converte em uma instância de um tipo especificado.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Converte o JsonNode que representa um único valor JSON em um `returnType`.
Deserialize(JsonElement, Type, JsonSerializerContext)	Converte o JsonElement que representa um único valor JSON em um `returnType`.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Converte o JsonElement que representa um único valor JSON em um `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Converte o JsonDocument que representa um único valor JSON em um `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Converte o JsonDocument que representa um único valor JSON em um `returnType`.
Deserialize(String, Type, JsonSerializerContext)	Analisa o texto que representa um único valor JSON em um `returnType`.
Deserialize(String, Type, JsonSerializerOptions)	Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Analisa o texto que representa um único valor JSON em um `returnType`.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.
Deserialize(JsonNode, Type, JsonSerializerContext)	Converte o JsonNode que representa um único valor JSON em um `returnType`.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analisa o texto codificado em UTF-8 que representa um único valor JSON em um `returnType`.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(String, JsonTypeInfo)	Analisa o texto que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(JsonDocument, JsonTypeInfo)	Converte o JsonDocument que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analisa o texto que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(JsonNode, JsonTypeInfo)	Converte o JsonNode que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em uma instância especificada pelo `jsonTypeInfo`.
Deserialize(Stream, Type, JsonSerializerOptions)	Lê o texto codificado em UTF-8 que representa um único valor JSON em um `returnType`. O Stream será lido até a conclusão.
Deserialize(Stream, Type, JsonSerializerContext)	Lê o texto codificado em UTF-8 que representa um único valor JSON em um `returnType`. O Stream será lido até a conclusão.
Deserialize(JsonElement, JsonTypeInfo)	Converte o JsonElement que representa um único valor JSON em uma instância especificada pelo `jsonTypeInfo`.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um `TValue`.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Converte o JsonDocument que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido dentro de uma instância do tipo especificado por um parâmetro de tipo genérico.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Converte o JsonNode que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Converte o JsonNode que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Converte o JsonElement que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Converte o JsonElement que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Converte o JsonDocument que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
Deserialize<TValue>(String, JsonSerializerOptions)	Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analisa o texto que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Analisa o texto codificado em UTF-8 que representa um único valor JSON em um `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Lê o texto codificado em UTF-8 que representa um único valor JSON em um `TValue`. O Stream será lido até a conclusão.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Lê o texto codificado em UTF-8 que representa um único valor JSON em um `TValue`. O Stream será lido até a conclusão.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analisa o texto que representa um único valor JSON em um `TValue`.

Deserialize(Stream, JsonTypeInfo)

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo. O Stream será lido até a conclusão.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

utf8Json: Stream

Dados JSON a serem analisados.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

utf8Json ou jsonTypeInfo é null.

JsonException

O JSON é inválido ou há dados restantes no Stream.

Aplica-se a

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um returnType.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

reader: Utf8JsonReader

O leitor a ser lido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType ou context é null.

JsonException

O JSON é inválido, returnType não é compatível com o JSON ou não foi possível ler um valor do leitor.

ArgumentException

reader está usando opções incompatíveis.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método no fornecido context não retornou um compatível JsonTypeInfo para returnType.

Comentários

Se a TokenType propriedade de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.

Após a conclusão desse método, reader é posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, AllowTrailingCommas, e MaxDepth CommentHandling são usados durante a leitura.

Aplica-se a

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido e o converte em uma instância de um tipo especificado.

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

reader: Utf8JsonReader

O leitor do qual o JSON é lido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento do serializador durante a leitura.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Não foi possível ler um valor do leitor.

ArgumentException

reader está usando opções incompatíveis.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Comentários

Se a TokenType propriedade de reader for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() determinar o início do valor.

Após a conclusão desse método, reader será posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, JsonReaderOptions.AllowTrailingCommas, e JsonReaderOptions.MaxDepth JsonReaderOptions.CommentHandling são usados durante a leitura.

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize(JsonNode, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Converte o JsonNode que representa um único valor JSON em um returnType.

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

node: JsonNode

O JsonNode a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

JsonException

returnType não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize(JsonElement, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Converte o JsonElement que representa um único valor JSON em um returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

element: JsonElement

O JsonElement a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

- ou -

context é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método do fornecido context retorna null para o tipo a ser convertido.

Aplica-se a

Deserialize(JsonElement, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Converte o JsonElement que representa um único valor JSON em um returnType.

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

element: JsonElement

O JsonElement a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

JsonException

returnType não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize(JsonDocument, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Converte o JsonDocument que representa um único valor JSON em um returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

document: JsonDocument

O JsonDocument a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

document é null.

- ou -

returnType é null.

- ou -

context é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método do fornecido context retorna null para o tipo a ser convertido.

Aplica-se a

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Converte o JsonDocument que representa um único valor JSON em um returnType.

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

document: JsonDocument

O JsonDocument a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

document ou returnType é null.

JsonException

returnType não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize(String, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em um returnType.

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

json: String

Texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

json ou returnType é null.

- ou -

context é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método do fornecido context retorna null para o tipo a ser convertido.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize(String, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

json: String

O texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

json ou returnType é null.

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em um returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

json: ReadOnlySpan<Char>

Texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

json ou returnType é null.

- ou -

context é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método do fornecido context retorna null para o tipo a ser convertido.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

json: ReadOnlySpan<Char>

O texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes no intervalo além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Comentários

Usar um intervalo UTF-16 não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize(JsonNode, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Converte o JsonNode que representa um único valor JSON em um returnType.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

node: JsonNode

O JsonNode a ser convertido.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

- ou -

context é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método do fornecido context retorna null para o tipo a ser convertido.

Aplica-se a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado.

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

utf8Json: ReadOnlySpan<Byte>

O texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

JsonException

O JSON é inválido.

- ou -

returnType não é compatível com o JSON.

- ou -

Há dados restantes no intervalo além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Comentários

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Analisa o texto codificado em UTF-8 que representa um único valor JSON em um returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON a ser analisado.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

returnType é null.

JsonException

O JSON é inválido, returnType não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método no fornecido context não retornou um compatível JsonTypeInfo para returnType.

Aplica-se a

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

JsonException

O JSON é inválido ou há dados restantes no buffer.

Aplica-se a

Deserialize(String, JsonTypeInfo)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

json: String

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

json é null.

- ou -

jsonTypeInfo é null.

JsonException

O JSON é inválido.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize(JsonDocument, JsonTypeInfo)

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Converte o JsonDocument que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

document: JsonDocument

O JsonDocument a ser convertido.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

document é null.

- ou -

jsonTypeInfo é null.

Aplica-se a

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

json: ReadOnlySpan<Char>

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

jsonTypeInfo é null.

JsonException

O JSON é inválido.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize(JsonNode, JsonTypeInfo)

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Converte o JsonNode que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

node: JsonNode

O JsonNode a ser convertido.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

jsonTypeInfo é null.

Aplica-se a

Deserialize(Utf8JsonReader, JsonTypeInfo)

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em uma instância especificada pelo jsonTypeInfo.

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

reader: Utf8JsonReader

O leitor a ser lido.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

JsonException

O JSON é inválido, jsonTypeInfo não é compatível com o JSON ou não foi possível ler um valor do leitor.

ArgumentException

reader está usando opções incompatíveis.

Comentários

Se a TokenType propriedade de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Aplica-se a

Deserialize(Stream, Type, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType. O Stream será lido até a conclusão.

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Parâmetros

utf8Json: Stream

Dados JSON a serem analisados.

returnType: Type

O tipo do objeto a ser convertido e retornado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a leitura.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

utf8Json ou returnType é null.

JsonException

O JSON é inválido, o returnType não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize(Stream, Type, JsonSerializerContext)

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType. O Stream será lido até a conclusão.

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object

Parâmetros

utf8Json: Stream

Dados JSON a serem analisados.

returnType: Type

O tipo do objeto a ser convertido e retornado.

context: JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

utf8Json, returnType ou context é null.

JsonException

O JSON é inválido, o returnType não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para returnType nem para os respectivos membros serializáveis.

InvalidOperationException

O GetTypeInfo(Type) método no fornecido context não retornou um compatível JsonTypeInfo para returnType.

Aplica-se a

Deserialize(JsonElement, JsonTypeInfo)

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Converte o JsonElement que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object

Parâmetros

element: JsonElement

O JsonElement a ser convertido.

jsonTypeInfo: JsonTypeInfo

Metadados sobre o tipo a ser convertido.

Retornos

Object

Uma representação jsonTypeInfo do valor JSON.

Exceções

ArgumentNullException

jsonTypeInfo é null.

Aplica-se a

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

reader: Utf8JsonReader

O leitor a ser lido.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

O JSON é inválido, TValue não é compatível com o JSON ou não foi possível ler um valor do leitor.

ArgumentException

reader está usando opções incompatíveis.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

Se a TokenType propriedade de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Aplica-se a

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Converte o JsonDocument que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

document: JsonDocument

O JsonDocument a ser convertido.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

document é null.

- ou -

jsonTypeInfo é null.

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Origem:: JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido dentro de uma instância do tipo especificado por um parâmetro de tipo genérico.

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo de destino do valor JSON.

Parâmetros

reader: Utf8JsonReader

O leitor do qual o JSON é lido.

options: JsonSerializerOptions

Opções para controlar o comportamento do serializador durante a leitura.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Não foi possível ler um valor do leitor.

ArgumentException

reader usa opções não compatíveis.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

Se a TokenType propriedade de reader for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() determinar o início do valor.

Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Converte o JsonNode que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

node: JsonNode

O JsonNode a ser convertido.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

jsonTypeInfo é null.

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Origem:: JsonSerializer.Read.Node.cs

Converte o JsonNode que representa um único valor JSON em um TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

node: JsonNode

O JsonNode a ser convertido.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Converte o JsonElement que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

element: JsonElement

O JsonElement a ser convertido.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

jsonTypeInfo é null.

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Origem:: JsonSerializer.Read.Element.cs

Converte o JsonElement que representa um único valor JSON em um TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

element: JsonElement

O JsonElement a ser convertido.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Origem:: JsonSerializer.Read.Document.cs

Converte o JsonDocument que representa um único valor JSON em um TValue.

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

document: JsonDocument

O JsonDocument a ser convertido.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

document é null.

JsonException

TValue não é compatível com o JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

json: ReadOnlySpan<Char>

O texto JSON a ser analisado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes no intervalo além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

O uso de um intervalo UTF-16 não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize<TValue>(String, JsonSerializerOptions)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo de destino do valor JSON.

Parâmetros

json: String

O texto JSON a ser analisado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

json é null.

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

json: ReadOnlySpan<Char>

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

json é null.

- ou -

jsonTypeInfo é null.

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Analisa o texto codificado em UTF-8 que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

utf8Json: ReadOnlySpan<Byte>

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

O JSON é inválido, TValue não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Origem:: JsonSerializer.Read.Span.cs

Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo de destino do texto codificado em UTF-8.

Parâmetros

utf8Json: ReadOnlySpan<Byte>

O texto JSON a ser analisado.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a análise.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes no intervalo além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

Para obter mais informações, consulte Como serializar e desserializar o JSON.

Aplica-se a

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue. O Stream será lido até a conclusão.

public:
generic <typename TValue>
 static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

utf8Json: Stream

Dados JSON a serem analisados.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

utf8Json ou jsonTypeInfo é null.

JsonException

O JSON é inválido, TValue não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(Stream, JsonSerializerOptions)

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Origem:: JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue. O Stream será lido até a conclusão.

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

utf8Json: Stream

Dados JSON a serem analisados.

options: JsonSerializerOptions

Opções para controlar o comportamento durante a leitura.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

utf8Json é null.

JsonException

O JSON é inválido, TValue não é compatível com o JSON ou há dados restantes no Stream.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Aplica-se a

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Origem:: JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em um TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parâmetros de tipo

TValue

O tipo no qual desserializar o valor JSON.

Parâmetros

json: String

Texto JSON a ser analisado.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadados sobre o tipo a ser convertido.

Retornos

TValue

Uma representação TValue do valor JSON.

Exceções

ArgumentNullException

json é null.

- ou -

jsonTypeInfo é null.

JsonException

O JSON é inválido.

- ou -

TValue não é compatível com o JSON.

- ou -

Há dados restantes na cadeia de caracteres além de um único valor JSON.

NotSupportedException

Não há nenhum JsonConverter compatível para TValue nem para os respectivos membros serializáveis.

Comentários

O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.

Aplica-se a