JsonSerializer.DeserializeAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Name | Description |
|---|---|
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Asynchronně čte zakódovaný text UTF-8 představující jednu hodnotu JSON do instance zadaného typu. Stream se přečte do dokončení. |
| DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu PipeReader se přečte do dokončení. |
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené znakem |
| DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené znakem PipeReader se přečte do dokončení. |
| DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu PipeReader se přečte do dokončení. |
| DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu PipeReader se přečte do dokončení. |
| DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu PipeReader se přečte do dokončení. |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Asynchronně čte zakódovaný text UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu. Stream se přečte do dokončení. |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu returnType.
Stream se přečte do dokončení.
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)
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat
- returnType
- Type
Typ objektu, na který se má převést a vrátit.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace returnType hodnoty JSON.
Výjimky
utf8Json, returnTypenebo context je null.
JSON je neplatný, returnType není kompatibilní s JSON nebo ve streamu jsou zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterreturnType .
Metoda GetTypeInfo(Type) na zadané context straně nevrátila kompatibilní JsonTypeInfo pro returnType.
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Deserialize(Stream, Type, JsonSerializerContext).
Platí pro
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Asynchronně čte zakódovaný text UTF-8 představující jednu hodnotu JSON do instance zadaného typu. Stream se přečte do dokončení.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat.
- returnType
- Type
Typ objektu, na který se má převést a vrátit.
- options
- JsonSerializerOptions
Možnosti řízení chování při čtení
- cancellationToken
- CancellationToken
Token zrušení, který lze použít ke zrušení operace čtení.
Návraty
Reprezentace returnType hodnoty JSON.
- Atributy
Výjimky
utf8Json nebo returnType je null.
Json je neplatný.
nebo
TValue není kompatibilní s JSON.
nebo
Ve streamu jsou zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterreturnType .
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Poznámky
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané Deserialize(Stream, Type, JsonSerializerOptions).
Platí pro
DeserializeAsync(PipeReader, Type, JsonSerializerContext, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu returnType.
PipeReader se přečte do dokončení.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametry
- utf8Json
- PipeReader
Data JSON, která se mají analyzovat
- returnType
- Type
Typ objektu, na který se má převést a vrátit.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace returnType hodnoty JSON.
Výjimky
utf8Json, returnTypenebo context je null.
KÓD JSON je neplatný, returnType není kompatibilní s JSON nebo v PipeReader existují zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterreturnType .
Metoda GetTypeInfo(Type) na zadané context straně nevrátila kompatibilní JsonTypeInfo pro returnType.
Platí pro
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené znakem jsonTypeInfo.
Stream se přečte do dokončení.
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)
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který chcete převést.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace jsonTypeInfo hodnoty JSON.
Výjimky
utf8Json nebo jsonTypeInfo je null.
JSON je neplatný nebo ve streamu jsou zbývající data.
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Platí pro
DeserializeAsync(PipeReader, JsonTypeInfo, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené znakem jsonTypeInfo.
PipeReader se přečte do dokončení.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametry
- utf8Json
- PipeReader
Data JSON, která se mají analyzovat
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který chcete převést.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace jsonTypeInfo hodnoty JSON.
Výjimky
utf8Json nebo jsonTypeInfo je null.
JSON je neplatný nebo v PipeReader jsou zbývající data.
Platí pro
DeserializeAsync(PipeReader, Type, JsonSerializerOptions, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu returnType.
PipeReader se přečte do dokončení.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync(System.IO.Pipelines.PipeReader utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
static member DeserializeAsync : System.IO.Pipelines.PipeReader * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As PipeReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametry
- utf8Json
- PipeReader
Data JSON, která se mají analyzovat
- returnType
- Type
Typ objektu, na který se má převést a vrátit.
- options
- JsonSerializerOptions
Možnosti řízení chování při čtení
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace returnType hodnoty JSON.
- Atributy
Výjimky
utf8Json nebo returnType je null.
KÓD JSON je neplatný, returnType není kompatibilní s JSON nebo v PipeReader existují zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterreturnType .
Platí pro
DeserializeAsync<TValue>(PipeReader, JsonSerializerOptions, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu TValue.
PipeReader se přečte do dokončení.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Parametry typu
- TValue
Typ pro deserializaci hodnoty JSON do.
Parametry
- utf8Json
- PipeReader
Data JSON, která se mají analyzovat
- options
- JsonSerializerOptions
Možnosti řízení chování při čtení
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace TValue hodnoty JSON.
- Atributy
Výjimky
utf8Json je null.
JSON je neplatný, TValue není kompatibilní s JSON nebo v PipeReader existují zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterTValue .
Platí pro
DeserializeAsync<TValue>(PipeReader, JsonTypeInfo<TValue>, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu TValue.
PipeReader se přečte do dokončení.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue>(System.IO.Pipelines.PipeReader utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Pipelines.PipeReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As PipeReader, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Parametry typu
- TValue
Typ pro deserializaci hodnoty JSON do.
Parametry
- utf8Json
- PipeReader
Data JSON, která se mají analyzovat
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který chcete převést.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace TValue hodnoty JSON.
Výjimky
utf8Json nebo jsonTypeInfo je null.
JSON je neplatný, TValue není kompatibilní s JSON nebo v PipeReader existují zbývající data.
Platí pro
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Asynchronně čte zakódovaný text UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu. Stream se přečte do dokončení.
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")]
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);
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("JSON serialization and deserialization might require types that cannot be statically analyzed and might need runtime code generation. Use System.Text.Json source generation for native AOT applications.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("JSON serialization and deserialization might require types that cannot be statically analyzed. Use the overload that takes a JsonTypeInfo or JsonSerializerContext, or make sure all of the required types are preserved.")>]
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Parametry typu
- TValue
Cílový typ hodnoty JSON.
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat.
- options
- JsonSerializerOptions
Možnosti řízení chování při čtení
- cancellationToken
- CancellationToken
Token, který lze použít ke zrušení operace čtení.
Návraty
Reprezentace TValue hodnoty JSON.
- Atributy
Výjimky
Json je neplatný.
nebo
TValue není kompatibilní s JSON.
nebo
Ve streamu jsou zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterTValue .
utf8Jsonje null.
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.
Poznámky
Další informace naleznete v tématu Jak serializovat a deserializovat JSON.
Platí pro
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do objektu TValue.
Stream se přečte do dokončení.
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)
Parametry typu
- TValue
Typ pro deserializaci hodnoty JSON do.
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který chcete převést.
- cancellationToken
- CancellationToken
Tuto CancellationToken operaci lze použít ke zrušení operace čtení.
Návraty
Reprezentace TValue hodnoty JSON.
Výjimky
utf8Json nebo jsonTypeInfo je null.
JSON je neplatný, TValue není kompatibilní s JSON nebo ve streamu jsou zbývající data.
Pro serializovatelné členy není kompatibilní JsonConverterTValue .
Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.