JsonSerializer.Deserialize Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

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

Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo. O Fluxo 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.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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 sem suporte.

NotSupportedException

Não há JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Comentários

Se a propriedade TokenType de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() para 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Os JsonReaderOptions usados para criar a instância do Utf8JsonReader têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, AllowTrailingCommas, MaxDepthe CommentHandling são usados durante a leitura.

Deserialize(JsonNode, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Deserialize(JsonNode, Type, JsonSerializerOptions)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

Deserialize(JsonElement, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Deserialize(JsonElement, Type, JsonSerializerOptions)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

Deserialize(JsonDocument, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Deserialize(JsonDocument, Type, JsonSerializerOptions)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

Deserialize(String, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Comentários

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

Deserialize(String, Type, JsonSerializerOptions)

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);

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

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

Comentários

Usar 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 desserializarJSON.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Comentários

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

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus 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.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

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);

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

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 ler o JSON.

returnType

Type

O tipo do objeto para o qual converter e retornar.

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 sem suporte.

NotSupportedException

Não há JsonConverter compatíveis para returnType ou seus membros serializáveis.

Comentários

Se a propriedade TokenType de reader for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() para 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Os JsonReaderOptions usados para criar a instância do Utf8JsonReader têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthe JsonReaderOptions.CommentHandling são usados durante a leitura.

Para obter mais informações, consulte Como serializar e desserializarJSON.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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);

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

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

Comentários

Para obter mais informações, consulte Como serializar e desserializarJSON.

Deserialize(Stream, Type, JsonSerializerContext)

Origem:

JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType. O Fluxo 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 para o qual converter e retornar.

context

JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Object

Uma representação returnType do valor JSON.

Exceções

ArgumentNullException

utf8Json, returnTypeou context é null.

JsonException

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

NotSupportedException

Não há JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Deserialize(Stream, Type, JsonSerializerOptions)

Origem:

JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType. O Fluxo 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 para o qual converter e retornar.

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 os dados restantes no Fluxo.

NotSupportedException

Não há JsonConverter compatíveis para returnType ou seus membros serializáveis.

Deserialize(Utf8JsonReader, JsonTypeInfo)

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 sem suporte.

Comentários

Se a propriedade TokenType de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() para 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Os JsonReaderOptions usados para criar a instância do Utf8JsonReader têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, AllowTrailingCommas, MaxDepthe CommentHandling são usados durante a leitura.

Deserialize(JsonNode, JsonTypeInfo)

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.

Deserialize(JsonElement, JsonTypeInfo)

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.

Deserialize(JsonDocument, JsonTypeInfo)

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.

Deserialize(String, JsonTypeInfo)

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

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

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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

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

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

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 para o qual converter e retornar.

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á JsonConverter compatíveis para returnType ou seus membros serializáveis.

InvalidOperationException

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

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

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

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 em que 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 sem suporte.

NotSupportedException

Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

Se a propriedade TokenType de reader for PropertyName ou None, o leitor será avançado por uma chamada para Read() para 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Os JsonReaderOptions usados para criar a instância do Utf8JsonReader têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, AllowTrailingCommas, MaxDepthe CommentHandling são usados durante a leitura.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Origem:

JsonSerializer.Read.Utf8JsonReader.cs

Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em uma instância do tipo especificada 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);

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

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 ler o JSON.

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 sem suporte.

NotSupportedException

Não há JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

Se a propriedade TokenType de reader for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() para 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 atuou, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.

Os JsonReaderOptions usados para criar a instância do Utf8JsonReader têm precedência sobre o JsonSerializerOptions quando entram em conflito. Portanto, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthe JsonReaderOptions.CommentHandling são usados durante a leitura.

Para obter mais informações, consulte Como serializar e desserializarJSON.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

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

Deserialize<TValue>(String, JsonSerializerOptions)

Origem:

JsonSerializer.Read.String.cs

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

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

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

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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

Usar 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 desserializarJSON.

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

Origem:

JsonSerializer.Read.String.cs

Analisa o texto que representa um único valor JSON em uma instância do tipo especificada 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 em que 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á JsonConverter compatíveis para TValue ou seus 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.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

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

Origem:

JsonSerializer.Read.Span.cs

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

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 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

Para obter mais informações, consulte Como serializar e desserializarJSON.

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

Origem:

JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue. O Fluxo 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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Origem:

JsonSerializer.Read.Stream.cs

Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue. O Fluxo 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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

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

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 em que 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á JsonConverter compatíveis para TValue ou seus membros serializáveis.

Comentários

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