Compartilhar via


JsonSerializer.Deserialize Método

Definição

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

utf8Json ou jsonTypeInfo é null.

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

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType ou context é null.

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

reader está usando opções sem suporte.

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

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.

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

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

-ou-

context é null.

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.

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

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

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

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

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

Não há JsonConverter compatíveis para returnType ou seus 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 para o qual converter e retornar.

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

-ou-

context é null.

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.

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

O método GetTypeInfo(Type) do context fornecido 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 para o qual converter e retornar.

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

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

Não há JsonConverter compatíveis para returnType ou seus 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 para o qual converter e retornar.

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

document é null.

-ou-

returnType é null.

-ou-

context é null.

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.

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

O método GetTypeInfo(Type) do context fornecido 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 para o qual converter e retornar.

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

document ou returnType é null.

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

Não há JsonConverter compatíveis para returnType ou seus 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 para o qual converter e retornar.

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

json ou returnType é null.

-ou-

context é null.

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.

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

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.

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

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

json ou returnType é null.

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.

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.

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

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

json ou returnType é null.

-ou-

context é null.

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.

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

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.

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

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

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.

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.

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

Uma representação returnType do valor JSON.

Exceções

returnType é null.

O JSON é inválido.

-ou-

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

-ou-

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

reader está usando opções sem suporte.

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.

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

options
JsonSerializerOptions

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

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

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.

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.

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

Uma representação returnType do valor JSON.

Exceções

utf8Json, returnTypeou context é null.

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

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

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

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

Uma representação returnType do valor JSON.

Exceções

utf8Json ou returnType é null.

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

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

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

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

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.

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

jsonTypeInfo é null.

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

jsonTypeInfo é null.

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

document é null.

-ou-

jsonTypeInfo é null.

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

json é null.

-ou-

jsonTypeInfo é null.

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.

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

Uma representação jsonTypeInfo do valor JSON.

Exceções

jsonTypeInfo é null.

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.

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

context
JsonSerializerContext

Um provedor de metadados para tipos serializáveis.

Retornos

Uma representação returnType do valor JSON.

Exceções

returnType é null.

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

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

O método GetTypeInfo(Type) no context fornecido não retornou um JsonTypeInfo compatível 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

Uma representação jsonTypeInfo do valor JSON.

Exceções

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

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

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

Não há JsonConverter compatíveis para TValue ou seus 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 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

jsonTypeInfo é null.

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

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

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

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

reader está usando opções sem suporte.

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.

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

jsonTypeInfo é null.

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

Não há JsonConverter compatíveis para TValue ou seus 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 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);
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 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

O JSON é inválido.

-ou-

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

-ou-

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

reader usa opções sem suporte.

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.

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

document é null.

-ou-

jsonTypeInfo é null.

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

Não há JsonConverter compatíveis para TValue ou seus 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 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

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

Não há JsonConverter compatíveis para TValue ou seus 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 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

document é null.

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

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

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

json é null.

-ou-

jsonTypeInfo é null.

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.

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.

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 especificada 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

json é null.

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.

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.

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

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.

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.

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

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

Não há JsonConverter compatíveis para TValue ou seus 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 especificada 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

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.

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.

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

utf8Json ou jsonTypeInfo é null.

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

Não há JsonConverter compatíveis para TValue ou seus 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 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

utf8Json é null.

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

Não há JsonConverter compatíveis para TValue ou seus 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 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

json é null.

-ou-

jsonTypeInfo é null.

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.

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.

Aplica-se a