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, Type, JsonSerializerContext, CancellationToken) |
Lee el texto codificado UTF-8 que representa un único valor JSON en un |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por . |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Lee asincrónicamente el texto con codificación UTF-8 que representa un único valor JSON en una instancia de un tipo especificado. La secuencia se lee hasta su finalización. |
| 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 asincrónicamente el texto con codificación 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 lee hasta su finalización. |
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
CancellationToken que se puede usar para cancelar la operación de lectura.
Devoluciones
Representación returnType del valor JSON.
Excepciones
utf8Json, returnType o context es null.
El JSON no es válido, no returnType es compatible con el JSON o hay datos restantes en stream.
No hay ningún JsonConverter compatible para returnType o sus miembros serializables.
El GetTypeInfo(Type) método en el proporcionado context no devolvió una compatibilidad para returnTypeJsonTypeInfo .
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 que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Deserialize(Stream, Type, JsonSerializerContext).
Se aplica a
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Lee el texto codificado UTF-8 que representa un único valor JSON en una instancia especificada por .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
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 asincrónicamente el texto con codificación UTF-8 que representa un único valor JSON en una instancia de un tipo especificado. La secuencia se lee hasta su 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 puede usarse 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 bien
TValue no es compatible con el JSON.
o bien
Hay datos restantes en la secuencia.
No hay ningún JsonConverter compatible para returnType o sus miembros serializables.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para más información, consulte Serialización y deserialización de JSON.
Este método almacena en la tarea que devuelve todas las excepciones que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Deserialize(Stream, Type, JsonSerializerOptions).
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
que CancellationToken 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 ningún JsonConverter compatible para TValue o 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 asincrónicamente el texto con codificación 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 lee hasta su 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 puede usarse para cancelar la operación de lectura.
Devoluciones
Representación TValue del valor JSON.
Excepciones
El JSON no es válido.
o bien
TValue no es compatible con el JSON.
o bien
Hay datos restantes en la secuencia.
No hay ningún JsonConverter compatible para TValue o sus miembros serializables.
El valor de utf8Json es null.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para más información, consulte Serialización y deserialización de JSON.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de