Condividi tramite


JsonSerializer.DeserializeAsync Metodo

Definizione

Overload

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo. Il flusso verrà letto fino al completamento.

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Legge in modo asincrono il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato. Il flusso verrà letto fino al completamento.

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un returnType. Il flusso verrà letto fino al completamento.

DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue. Il flusso verrà letto fino al completamento.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Legge in modo asincrono il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato da un parametro di tipo generico. Il flusso verrà letto fino al completamento.

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata dal jsonTypeInfo. Il flusso verrà letto fino al completamento.

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parametri

utf8Json
Stream

Dati JSON da analizzare.

jsonTypeInfo
JsonTypeInfo

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di lettura.

Restituisce

Rappresentazione jsonTypeInfo del valore JSON.

Eccezioni

utf8Json o jsonTypeInfo è null.

Il codice JSON non è valido o quando sono presenti dati rimanenti nel flusso.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs

Legge in modo asincrono il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato. Il flusso verrà letto fino al completamento.

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<object> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parametri

utf8Json
Stream

Dati JSON da analizzare.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante la lettura.

cancellationToken
CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione di lettura.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

utf8Json o returnType è null.

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nel flusso sono presenti dati rimanenti.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Deserialize(Stream, Type, JsonSerializerOptions).

Si applica a

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un returnType. Il flusso verrà letto fino al completamento.

public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)

Parametri

utf8Json
Stream

Dati JSON da analizzare.

returnType
Type

Tipo dell'oggetto in cui eseguire la conversione e la restituzione.

context
JsonSerializerContext

Provider di metadati per i tipi serializzabili.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di lettura.

Restituisce

Rappresentazione returnType del valore JSON.

Eccezioni

utf8Json, returnTypeo context è null.

Il codice JSON non è valido, il returnType non è compatibile con il codice JSON o sono presenti dati rimanenti nel flusso.

Non esiste alcuna JsonConverter compatibile per returnType o i relativi membri serializzabili.

Il metodo GetTypeInfo(Type) nel context fornito non ha restituito un JsonTypeInfo compatibile per returnType.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Deserialize(Stream, Type, JsonSerializerContext).

Si applica a

DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)

Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs

Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un TValue. Il flusso verrà letto fino al completamento.

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Parametri di tipo

TValue

Tipo in cui deserializzare il valore JSON.

Parametri

utf8Json
Stream

Dati JSON da analizzare.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadati sul tipo da convertire.

cancellationToken
CancellationToken

Il CancellationToken che può essere utilizzato per annullare l'operazione di lettura.

Restituisce

ValueTask<TValue>

Rappresentazione TValue del valore JSON.

Eccezioni

utf8Json o jsonTypeInfo è null.

Il codice JSON non è valido, TValue non è compatibile con il codice JSON o sono presenti dati rimanenti in Stream.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Si applica a

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs
Origine:
JsonSerializer.Read.Stream.cs

Legge in modo asincrono il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza di un tipo specificato da un parametro di tipo generico. Il flusso verrà letto fino al completamento.

public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)

Parametri di tipo

TValue

Tipo di destinazione del valore JSON.

Parametri

utf8Json
Stream

Dati JSON da analizzare.

options
JsonSerializerOptions

Opzioni per controllare il comportamento durante la lettura.

cancellationToken
CancellationToken

Token che può essere usato per annullare l'operazione di lettura.

Restituisce

ValueTask<TValue>

Rappresentazione TValue del valore JSON.

Eccezioni

JSON non valido.

-o-

TValue non è compatibile con json.

-o-

Nel flusso sono presenti dati rimanenti.

Non esiste alcuna JsonConverter compatibile per TValue o i relativi membri serializzabili.

utf8Jsonè null.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni, vedere Come serializzare e deserializzare JSON.

Si applica a