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í
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Načte text kódovaný UTF-8 představující jednu hodnotu JSON do instance určené parametrem |
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Asynchronně přečte text kódovaný UTF-8 představující jednu hodnotu JSON do instance zadaného typu. Datový proud se přečte až do dokončení. |
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do |
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Asynchronně přečte text kódovaný UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu. Datový proud se přečte až do dokončení. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do returnType
.
Stream se přečte až 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
Hodnota CancellationToken , která se dá použít ke zrušení operace čtení.
Návraty
Reprezentace returnType
hodnoty JSON.
Výjimky
utf8Json
, returnType
nebo context
je null
.
Kód JSON je neplatný, returnType
není kompatibilní s kódem JSON nebo ve streamu zůstávají data.
Neexistuje žádný kompatibilní JsonConverter pro returnType
nebo jeho serializovatelné členy.
Metoda GetTypeInfo(Type) v zadaném context
souboru nevrátila kompatibilní JsonTypeInfo pro returnType
.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Deserialize(Stream, Type, JsonSerializerContext).
Platí pro
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Načte text kódovaný UTF-8 představující jednu hodnotu JSON do instance určené parametrem jsonTypeInfo
.
Stream se přečte až 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ý se má převést.
- cancellationToken
- CancellationToken
Hodnota CancellationToken , která se dá použít ke zrušení operace čtení.
Návraty
Reprezentace jsonTypeInfo
hodnoty JSON.
Výjimky
utf8Json
nebo jsonTypeInfo
je null
.
Json je neplatný nebo pokud stream obsahuje zbývající data.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Platí pro
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Asynchronně přečte text kódovaný UTF-8 představující jednu hodnotu JSON do instance zadaného typu. Datový proud se přečte až do dokončení.
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)
Parametry
- utf8Json
- Stream
Data JSON, která se mají parsovat.
- returnType
- Type
Typ objektu, na který se má převést a vrátit.
- options
- JsonSerializerOptions
Možnosti pro ří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.
Výjimky
utf8Json
nebo returnType
je null
.
Json je neplatný.
-nebo-
TValue
není kompatibilní se souborem JSON.
-nebo-
Ve streamu jsou zbývající data.
Neexistuje žádný kompatibilní JsonConverter pro returnType
nebo jeho serializovatelné členy.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Deserialize(Stream, Type, JsonSerializerOptions).
Platí pro
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do TValue
.
Stream se přečte až 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, do který se má deserializovat hodnota JSON.
Parametry
- utf8Json
- Stream
Data JSON, která se mají analyzovat.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který se má převést.
- cancellationToken
- CancellationToken
Který CancellationToken může být použit ke zrušení operace čtení.
Návraty
Reprezentace TValue
hodnoty JSON.
Výjimky
utf8Json
nebo jsonTypeInfo
je null
.
Kód JSON je neplatný, TValue
není kompatibilní s kódem JSON nebo stream obsahuje zbývající data.
Neexistuje žádný kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Platí pro
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Asynchronně přečte text kódovaný UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu. Datový proud se přečte až do dokončení.
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)
Parametry typu
- TValue
Cílový typ hodnoty JSON.
Parametry
- utf8Json
- Stream
Data JSON, která se mají parsovat.
- options
- JsonSerializerOptions
Možnosti pro řízení chování při čtení.
- cancellationToken
- CancellationToken
Token, který lze použít ke zrušení operace čtení.
Návraty
Reprezentace TValue
hodnoty JSON.
Výjimky
Json je neplatný.
-nebo-
TValue
není kompatibilní se souborem JSON.
-nebo-
Ve streamu jsou zbývající data.
Neexistuje žádný kompatibilní JsonConverter pro TValue
nebo jeho serializovatelné členy.
utf8Json
je null
.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro