JsonSerializer.DeserializeAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |
| 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 |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Lit le texte encodé UTF-8 représentant une valeur JSON unique dans un |
| 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)
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)
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)
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)
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
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)
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
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.
