JsonSerializer.Deserialize Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
Deserialize(Stream, JsonTypeInfo) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um |
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions) |
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido e o converte em uma instância de um tipo especificado. |
Deserialize(JsonNode, Type, JsonSerializerOptions) |
Converte o JsonNode que representa um único valor JSON em um |
Deserialize(JsonElement, Type, JsonSerializerContext) |
Converte o JsonElement que representa um único valor JSON em um |
Deserialize(JsonElement, Type, JsonSerializerOptions) |
Converte o JsonElement que representa um único valor JSON em um |
Deserialize(JsonDocument, Type, JsonSerializerContext) |
Converte o JsonDocument que representa um único valor JSON em um |
Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Converte o JsonDocument que representa um único valor JSON em um |
Deserialize(String, Type, JsonSerializerContext) |
Analisa o texto que representa um único valor JSON em um |
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 |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions) |
Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado. |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Converte o JsonNode que representa um único valor JSON em um |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions) |
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado. |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Analisa o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo |
Deserialize(String, JsonTypeInfo) |
Analisa o texto que representa um único valor JSON em uma instância especificada pelo |
Deserialize(JsonDocument, JsonTypeInfo) |
Converte o JsonDocument que representa um único valor JSON em uma instância especificada pelo |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Analisa o texto que representa um único valor JSON em uma instância especificada pelo |
Deserialize(JsonNode, JsonTypeInfo) |
Converte o JsonNode que representa um único valor JSON em uma instância especificada pelo |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em uma instância especificada pelo |
Deserialize(Stream, Type, JsonSerializerOptions) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize(Stream, Type, JsonSerializerContext) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize(JsonElement, JsonTypeInfo) |
Converte o JsonElement que representa um único valor JSON em uma instância especificada pelo |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um |
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>) |
Converte o JsonDocument que representa um único valor JSON em um |
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions) |
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido dentro de uma instância do tipo especificado por um parâmetro de tipo genérico. |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Converte o JsonNode que representa um único valor JSON em um |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Converte o JsonNode que representa um único valor JSON em um |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Converte o JsonElement que representa um único valor JSON em um |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Converte o JsonElement que representa um único valor JSON em um |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Converte o JsonDocument que representa um único valor JSON em um |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions) |
Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico. |
Deserialize<TValue>(String, JsonSerializerOptions) |
Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico. |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Analisa o texto que representa um único valor JSON em um |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>) |
Analisa o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions) |
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico. |
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Lê o texto codificado em UTF-8 que representa um único valor JSON em um |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Analisa o texto que representa um único valor JSON em um |
Deserialize(Stream, JsonTypeInfo)
Lê o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo
.
O Stream será lido até a conclusão.
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)
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um returnType
.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- reader
- Utf8JsonReader
O leitor a ser lido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
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 incompatíveis.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método no fornecido context
não retornou um compatível JsonTypeInfo para returnType
.
Comentários
Se a TokenType propriedade de reader
for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.
Após a conclusão desse método, reader
é posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.
Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.
O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, AllowTrailingCommas, e MaxDepthCommentHandling são usados durante a leitura.
Aplica-se a
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.
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- reader
- Utf8JsonReader
O leitor do qual o JSON é lido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento do serializador durante a leitura.
Retornos
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 incompatíveis.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Comentários
Se a TokenType propriedade de reader
for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() determinar o início do valor.
Após a conclusão desse método, reader
será posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.
Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.
O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, JsonReaderOptions.AllowTrailingCommas, e JsonReaderOptions.MaxDepthJsonReaderOptions.CommentHandling são usados durante a leitura.
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize(JsonNode, Type, JsonSerializerOptions)
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
Converte o JsonNode que representa um único valor JSON em um returnType
.
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- 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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize(JsonElement, Type, JsonSerializerContext)
Converte o JsonElement que representa um único valor JSON em um returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- element
- JsonElement
O JsonElement a ser convertido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método do fornecido context
retorna null
para o tipo a ser convertido.
Aplica-se a
Deserialize(JsonElement, Type, JsonSerializerOptions)
Converte o JsonElement que representa um único valor JSON em um returnType
.
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- element
- JsonElement
O JsonElement a ser convertido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
Uma representação returnType
do valor JSON.
Exceções
returnType
é null
.
returnType
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize(JsonDocument, Type, JsonSerializerContext)
Converte o JsonDocument que representa um único valor JSON em um returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- document
- JsonDocument
O JsonDocument a ser convertido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método do fornecido context
retorna null
para o tipo a ser convertido.
Aplica-se a
Deserialize(JsonDocument, Type, JsonSerializerOptions)
Converte o JsonDocument que representa um único valor JSON em um returnType
.
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- document
- JsonDocument
O JsonDocument a ser convertido.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
Uma representação returnType
do valor JSON.
Exceções
document
ou returnType
é null
.
returnType
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize(String, Type, JsonSerializerContext)
Analisa o texto que representa um único valor JSON em um returnType
.
public:
static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- json
- String
Texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método do fornecido context
retorna null
para o tipo a ser convertido.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize(String, Type, JsonSerializerOptions)
Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.
public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- json
- String
O texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
Analisa o texto que representa um único valor JSON em um returnType
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- json
- ReadOnlySpan<Char>
Texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método do fornecido context
retorna null
para o tipo a ser convertido.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
Analisa o texto que representa um único valor JSON em uma instância de um tipo especificado.
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- json
- ReadOnlySpan<Char>
O texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Comentários
Usar um intervalo UTF-16 não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize(JsonNode, Type, JsonSerializerContext)
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
Converte o JsonNode que representa um único valor JSON em um returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método do fornecido context
retorna null
para o tipo a ser convertido.
Aplica-se a
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância de um tipo especificado.
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- utf8Json
- ReadOnlySpan<Byte>
O texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Comentários
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
Analisa o texto codificado em UTF-8 que representa um único valor JSON em um returnType
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- utf8Json
- ReadOnlySpan<Byte>
Texto JSON a ser analisado.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
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á nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método no fornecido context
não retornou um compatível JsonTypeInfo para returnType
.
Aplica-se a
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object
Parâmetros
- utf8Json
- ReadOnlySpan<Byte>
Texto JSON a ser analisado.
- jsonTypeInfo
- JsonTypeInfo
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação jsonTypeInfo
do valor JSON.
Exceções
O JSON é inválido ou há dados restantes no buffer.
Aplica-se a
Deserialize(String, JsonTypeInfo)
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
O JSON é inválido.
- ou -
Há dados restantes na cadeia de caracteres além de um único valor JSON.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize(JsonDocument, JsonTypeInfo)
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
Aplica-se a
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
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
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize(JsonNode, JsonTypeInfo)
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
Converte o JsonNode que representa um único valor JSON em uma instância especificada pelo jsonTypeInfo
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object
Parâmetros
- 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(Utf8JsonReader, JsonTypeInfo)
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 incompatíveis.
Comentários
Se a TokenType propriedade de reader
for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.
Após a conclusão desse método, reader
será posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.
Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.
O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, AllowTrailingCommas, e MaxDepthCommentHandling são usados durante a leitura.
Aplica-se a
Deserialize(Stream, Type, JsonSerializerOptions)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType
.
O Stream será lido até a conclusão.
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
Retornos
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 há dados restantes no Stream.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize(Stream, Type, JsonSerializerContext)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um returnType
.
O Stream será lido até a conclusão.
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object
Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- returnType
- Type
O tipo do objeto a ser convertido e retornado.
- context
- JsonSerializerContext
Um provedor de metadados para tipos serializáveis.
Retornos
Uma representação returnType
do valor JSON.
Exceções
utf8Json
, returnType
ou context
é null
.
O JSON é inválido, o returnType
não é compatível com o JSON ou há dados restantes no Stream.
Não há nenhum JsonConverter compatível para returnType
nem para os respectivos membros serializáveis.
O GetTypeInfo(Type) método no fornecido context
não retornou um compatível JsonTypeInfo para returnType
.
Aplica-se a
Deserialize(JsonElement, JsonTypeInfo)
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<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido em um TValue
.
public:
generic <typename TValue>
static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- reader
- Utf8JsonReader
O leitor a ser lido.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
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 incompatíveis.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
Se a TokenType propriedade de reader
for PropertyName ou None, o leitor será avançado por uma chamada para Read() determinar o início do valor.
Após a conclusão desse método, reader
é posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.
Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.
O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, AllowTrailingCommas, e MaxDepthCommentHandling são usados durante a leitura.
Aplica-se a
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
Converte o JsonDocument que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- document
- JsonDocument
O JsonDocument a ser convertido.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação TValue
do valor JSON.
Exceções
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
Lê um valor JSON (incluindo objetos ou matrizes) do leitor fornecido dentro de uma instância do tipo especificado por um parâmetro de tipo genérico.
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo de destino do valor JSON.
Parâmetros
- reader
- Utf8JsonReader
O leitor do qual o JSON é lido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento do serializador durante a leitura.
Retornos
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 não compatíveis.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
Se a TokenType propriedade de reader
for JsonTokenType.PropertyName ou JsonTokenType.None, o leitor será avançado por uma chamada para Utf8JsonReader.Read() determinar o início do valor.
Após a conclusão desse método, reader
será posicionado no token final no valor JSON. Se uma exceção for gerada, o leitor será redefinido para o estado em que estava quando o método foi chamado.
Esse método faz uma cópia dos dados em que o leitor agiu, portanto, não há nenhum requisito de chamador para manter a integridade dos dados além do retorno desse método.
O JsonReaderOptions usado para criar a instância do Utf8JsonReader tem precedência sobre o JsonSerializerOptions quando eles entram em conflito. Portanto, JsonReaderOptions.AllowTrailingCommas, e JsonReaderOptions.MaxDepthJsonReaderOptions.CommentHandling são usados durante a leitura.
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
Converte o JsonNode que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação TValue
do valor JSON.
Exceções
jsonTypeInfo
é null
.
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
- Origem:
- JsonSerializer.Read.Node.cs
Converte o JsonNode que representa um único valor JSON em um TValue
.
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
Uma representação TValue
do valor JSON.
Exceções
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
Converte o JsonElement que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- element
- JsonElement
O JsonElement a ser convertido.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
Uma representação TValue
do valor JSON.
Exceções
jsonTypeInfo
é null
.
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
Converte o JsonElement que representa um único valor JSON em um TValue
.
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- element
- JsonElement
O JsonElement a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
Uma representação TValue
do valor JSON.
Exceções
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
Converte o JsonDocument que representa um único valor JSON em um TValue
.
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- document
- JsonDocument
O JsonDocument a ser convertido.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
Uma representação TValue
do valor JSON.
Exceções
document
é null
.
TValue
não é compatível com o JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- json
- ReadOnlySpan<Char>
O texto JSON a ser analisado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
O uso de um intervalo UTF-16 não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize<TValue>(String, JsonSerializerOptions)
Analisa o texto que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo de destino do valor JSON.
Parâmetros
- json
- String
O texto JSON a ser analisado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
Analisa o texto que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- json
- ReadOnlySpan<Char>
Texto JSON a ser analisado.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
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 na cadeia de caracteres além de um único valor JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
Analisa o texto codificado em UTF-8 que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- utf8Json
- ReadOnlySpan<Byte>
Texto JSON a ser analisado.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
- Origem:
- JsonSerializer.Read.Span.cs
Analisa o texto codificado em UTF-8 que representa um único valor JSON em uma instância do tipo especificado por um parâmetro de tipo genérico.
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo de destino do texto codificado em UTF-8.
Parâmetros
- utf8Json
- ReadOnlySpan<Byte>
O texto JSON a ser analisado.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a análise.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
Para obter mais informações, consulte Como serializar e desserializar o JSON.
Aplica-se a
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue
.
O Stream será lido até a conclusão.
public:
generic <typename TValue>
static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(Stream, JsonSerializerOptions)
Lê o texto codificado em UTF-8 que representa um único valor JSON em um TValue
.
O Stream será lido até a conclusão.
public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- utf8Json
- Stream
Dados JSON a serem analisados.
- options
- JsonSerializerOptions
Opções para controlar o comportamento durante a leitura.
Retornos
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á nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Aplica-se a
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
Analisa o texto que representa um único valor JSON em um TValue
.
public:
generic <typename TValue>
static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Parâmetros de tipo
- TValue
O tipo no qual desserializar o valor JSON.
Parâmetros
- json
- String
Texto JSON a ser analisado.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadados sobre o tipo a ser convertido.
Retornos
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 na cadeia de caracteres além de um único valor JSON.
Não há nenhum JsonConverter compatível para TValue
nem para os respectivos membros serializáveis.
Comentários
O uso de um String não é tão eficiente quanto usar os métodos UTF-8, pois a implementação usa nativamente UTF-8.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de