Partager via


JsonSerializer.DeserializeAsync Méthode

Définition

Surcharges

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans une instance spécifiée par le jsonTypeInfo. Le flux sera lu à la fin.

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Lit de façon asynchrone le texte encodé UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié. Le flux sera lu à la fin.

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu à la fin.

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

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un TValue. Le flux sera lu à la fin.

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Lit de façon asynchrone le texte encodé UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié par un paramètre de type générique. Le flux sera lu à la fin.

DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans une instance spécifiée par le jsonTypeInfo. Le flux sera lu à la fin.

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)

Paramètres

utf8Json
Stream

Données JSON à analyser.

jsonTypeInfo
JsonTypeInfo

Métadonnées sur le type à convertir.

cancellationToken
CancellationToken

Le CancellationToken qui peut être utilisé pour annuler l’opération de lecture.

Retours

Représentation jsonTypeInfo de la valeur JSON.

Exceptions

utf8Json ou jsonTypeInfo est null.

Le code JSON n’est pas valide ou s’il y a des données restantes dans le flux.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

S’applique à

DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

Lit de façon asynchrone le texte encodé UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié. Le flux sera lu à la fin.

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)

Paramètres

utf8Json
Stream

Données JSON à analyser.

returnType
Type

Type de l’objet à convertir et à retourner.

options
JsonSerializerOptions

Options permettant de contrôler le comportement pendant la lecture.

cancellationToken
CancellationToken

Jeton d’annulation qui peut être utilisé pour annuler l’opération de lecture.

Retours

Représentation returnType de la valeur JSON.

Exceptions

utf8Json ou returnType est null.

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il y a des données restantes dans le flux.

Il n’existe aucune JsonConverter compatible pour returnType ou ses membres sérialisables.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations, consultez Comment sérialiser et désérialiser json.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Deserialize(Stream, Type, JsonSerializerOptions).

S’applique à

DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un returnType. Le flux sera lu à la fin.

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)

Paramètres

utf8Json
Stream

Données JSON à analyser.

returnType
Type

Type de l’objet à convertir et à retourner.

context
JsonSerializerContext

Fournisseur de métadonnées pour les types sérialisables.

cancellationToken
CancellationToken

Le CancellationToken qui peut être utilisé pour annuler l’opération de lecture.

Retours

Représentation returnType de la valeur JSON.

Exceptions

utf8Json, returnTypeou context est null.

Le code JSON n’est pas valide, le returnType n’est pas compatible avec le json ou il existe des données restantes dans le flux.

Il n’existe aucune JsonConverter compatible pour returnType ou ses membres sérialisables.

La méthode GetTypeInfo(Type) sur le context fourni n’a pas retourné de JsonTypeInfo compatible pour returnType.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Deserialize(Stream, Type, JsonSerializerContext).

S’applique à

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

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un TValue. Le flux sera lu à la fin.

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)

Paramètres de type

TValue

Type dans lequel désérialiser la valeur JSON.

Paramètres

utf8Json
Stream

Données JSON à analyser.

jsonTypeInfo
JsonTypeInfo<TValue>

Métadonnées sur le type à convertir.

cancellationToken
CancellationToken

Le CancellationToken qui peut être utilisé pour annuler l’opération de lecture.

Retours

ValueTask<TValue>

Représentation TValue de la valeur JSON.

Exceptions

utf8Json ou jsonTypeInfo est null.

Le code JSON n’est pas valide, TValue n’est pas compatible avec le JSON ou il existe des données restantes dans le flux.

Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

S’applique à

DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)

Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs
Source:
JsonSerializer.Read.Stream.cs

Lit de façon asynchrone le texte encodé UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié par un paramètre de type générique. Le flux sera lu à la fin.

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)

Paramètres de type

TValue

Type cible de la valeur JSON.

Paramètres

utf8Json
Stream

Données JSON à analyser.

options
JsonSerializerOptions

Options permettant de contrôler le comportement pendant la lecture.

cancellationToken
CancellationToken

Jeton qui peut être utilisé pour annuler l’opération de lecture.

Retours

ValueTask<TValue>

Représentation TValue de la valeur JSON.

Exceptions

Le code JSON n’est pas valide.

-ou-

TValue n’est pas compatible avec le json.

-ou-

Il y a des données restantes dans le flux.

Il n’existe aucune JsonConverter compatible pour TValue ou ses membres sérialisables.

utf8Jsonest null.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations, consultez Comment sérialiser et désérialiser json.

S’applique à