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, Type, JsonSerializerContext, CancellationToken) |
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par . |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Lit de manière asynchrone le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié. Le flux sera lu dans son intégralité. |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Lit de façon asynchrone le texte encodé en 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 dans son intégralité. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un returnType.
Le flux sera lu jusqu’à 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
CancellationToken qui peut être utilisé pour annuler l’opération de lecture.
Retours
Représentation returnType de la valeur JSON.
Exceptions
utf8Json, returnType ou context est null.
Le JSON n’est pas valide, le returnType n’est pas compatible avec le JSON ou il reste des données dans le flux.
Il n’existe pas de JsonConverter compatible pour returnType ou ses membres sérialisables.
La GetTypeInfo(Type) méthode sur le fourni context n’a pas retourné de compatible JsonTypeInfo 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Deserialize(Stream, Type, JsonSerializerContext).
S’applique à
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un instance spécifié par .jsonTypeInfo
Le flux sera lu jusqu’à 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 relatives au type à convertir.
- cancellationToken
- CancellationToken
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 lorsqu’il reste des données 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 manière asynchrone le texte encodé en UTF-8 représentant une valeur JSON unique dans une instance d’un type spécifié. Le flux sera lu dans son intégralité.
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 lors de la lecture.
- cancellationToken
- CancellationToken
Jeton d’annulation pouvant être utilisé pour annuler l’opération de lecture.
Retours
Représentation returnType de la valeur JSON.
Exceptions
utf8Json ou returnType est null.
Le JSON n’est pas valide.
- ou -
TValue n’est pas compatible avec le JSON.
- ou -
Il reste des données dans le flux.
Il n’existe pas de 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Deserialize(Stream, Type, JsonSerializerOptions).
S’applique à
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Lit le texte encodé UTF-8 représentant une seule valeur JSON dans un TValue.
Le flux sera lu jusqu’à 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 relatives au type à convertir.
- cancellationToken
- CancellationToken
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 json n’est pas valide, TValue n’est pas compatible avec le JSON ou il reste des données dans le flux.
Il n’existe pas de 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é en 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 dans son intégralité.
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 lors de la lecture.
- cancellationToken
- CancellationToken
Jeton pouvant être utilisé pour annuler l’opération de lecture.
Retours
Représentation TValue de la valeur JSON.
Exceptions
Le JSON n’est pas valide.
- ou -
TValue n’est pas compatible avec le JSON.
- ou -
Il reste des données dans le flux.
Il n’existe pas de JsonConverter compatible pour TValue ou ses membres sérialisables.
utf8Json a la valeur 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 à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour