JsonSerializer.DeserializeAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un'istanza specificata dal |
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 |
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Legge il testo con codifica UTF-8 che rappresenta un singolo valore JSON in un |
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
, returnType
o 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
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
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.