JsonSerializer.DeserializeAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Lee de forma asincrónica el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado. La secuencia se leerá hasta la finalización. |
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Lee el texto codificado UTF-8 que representa un único valor JSON en un |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Lee el texto codificado UTF-8 que representa un único valor JSON en un |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Lee de forma asincrónica el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado por un parámetro de tipo genérico. La secuencia se leerá hasta la finalización. |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por el jsonTypeInfo.
La secuencia se leerá hasta la finalización.
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)Parámetros
- utf8Json
- Stream
Datos JSON que se van a analizar.
- jsonTypeInfo
- JsonTypeInfo
Metadatos sobre el tipo que se va a convertir.
- cancellationToken
- CancellationToken
El CancellationToken que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación jsonTypeInfo del valor JSON.
Excepciones
utf8Json o jsonTypeInfo es null.
El json no es válido o cuando hay datos restantes en stream.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Lee de forma asincrónica el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado. La secuencia se leerá hasta la finalización.
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)Parámetros
- utf8Json
- Stream
Datos JSON que se van a analizar.
- returnType
- Type
Tipo del objeto al que se va a convertir y devolver.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento durante la lectura.
- cancellationToken
- CancellationToken
Token de cancelación que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación returnType del valor JSON.
Excepciones
utf8Json o returnType es null.
El JSON no es válido.
-o-
TValue no es compatible con json.
-o-
Hay datos restantes en la secuencia.
No hay JsonConverter compatibles para returnType ni sus miembros serializables.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para obtener más información, consulte Cómo serializar y deserializar JSON.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Deserialize(Stream, Type, JsonSerializerOptions).
Se aplica a
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Lee el texto codificado UTF-8 que representa un único valor JSON en un returnType.
La secuencia se leerá hasta la finalización.
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)Parámetros
- utf8Json
- Stream
Datos JSON que se van a analizar.
- returnType
- Type
Tipo del objeto al que se va a convertir y devolver.
- context
- JsonSerializerContext
Proveedor de metadatos para tipos serializables.
- cancellationToken
- CancellationToken
El CancellationToken que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación returnType del valor JSON.
Excepciones
utf8Json, returnTypeo context es null.
El json no es válido, el returnType no es compatible con el JSON o hay datos restantes en stream.
No hay JsonConverter compatibles para returnType ni sus miembros serializables.
El método GetTypeInfo(Type) en el context proporcionado no devolvió un JsonTypeInfo compatible para returnType.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Deserialize(Stream, Type, JsonSerializerContext).
Se aplica a
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Lee el texto codificado UTF-8 que representa un único valor JSON en un TValue.
La secuencia se leerá hasta la finalización.
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)Parámetros de tipo
- TValue
Tipo en el que se va a deserializar el valor JSON.
Parámetros
- utf8Json
- Stream
Datos JSON que se van a analizar.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadatos sobre el tipo que se va a convertir.
- cancellationToken
- CancellationToken
El CancellationToken que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación TValue del valor JSON.
Excepciones
utf8Json o jsonTypeInfo es null.
El JSON no es válido, TValue no es compatible con el JSON o hay datos restantes en stream.
No hay JsonConverter compatibles para TValue ni sus miembros serializables.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Lee de forma asincrónica el texto codificado UTF-8 que representa un único valor JSON en una instancia de un tipo especificado por un parámetro de tipo genérico. La secuencia se leerá hasta la finalización.
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)Parámetros de tipo
- TValue
Tipo de destino del valor JSON.
Parámetros
- utf8Json
- Stream
Datos JSON que se van a analizar.
- options
- JsonSerializerOptions
Opciones para controlar el comportamiento durante la lectura.
- cancellationToken
- CancellationToken
Token que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación TValue del valor JSON.
Excepciones
El JSON no es válido.
-o-
TValue no es compatible con json.
-o-
Hay datos restantes en la secuencia.
No hay JsonConverter compatibles para TValue ni sus miembros serializables.
utf8Jsones null.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para obtener más información, consulte Cómo serializar y deserializar JSON.
