JsonSerializer.DeserializeAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez |
| DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu. Strumień zostanie odczytany do ukończenia. |
| DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w |
| DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w |
| DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego. Strumień zostanie odczytany do ukończenia. |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo.
Strumień zostanie odczytany do ukończenia.
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
Dane JSON do analizy.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
CancellationToken, których można użyć do anulowania operacji odczytu.
Zwraca
jsonTypeInfo reprezentacja wartości JSON.
Wyjątki
utf8Json lub jsonTypeInfo jest null.
Kod JSON jest nieprawidłowy lub gdy w usłudze Stream istnieją pozostałe dane.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Dotyczy
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu. Strumień zostanie odczytany do ukończenia.
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
Dane JSON do przeanalizowana.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas odczytywania.
- cancellationToken
- CancellationToken
Token anulowania, który może służyć do anulowania operacji odczytu.
Zwraca
returnType reprezentacja wartości JSON.
Wyjątki
utf8Json lub returnType jest null.
Kod JSON jest nieprawidłowy.
-lub-
TValue nie jest zgodny z plikiem JSON.
-lub-
W strumieniu znajdują się pozostałe dane.
Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez Deserialize(Stream, Type, JsonSerializerOptions).
Dotyczy
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType.
Strumień zostanie odczytany do ukończenia.
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
Dane JSON do analizy.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów możliwych do serializacji.
- cancellationToken
- CancellationToken
CancellationToken, których można użyć do anulowania operacji odczytu.
Zwraca
returnType reprezentacja wartości JSON.
Wyjątki
utf8Json, returnTypelub context jest null.
Kod JSON jest nieprawidłowy, returnType nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) w podanym context nie zwróciła zgodnego JsonTypeInfo dla returnType.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez Deserialize(Stream, Type, JsonSerializerContext).
Dotyczy
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue.
Strumień zostanie odczytany do ukończenia.
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 deserializacji wartości JSON.
Parametry
- utf8Json
- Stream
Dane JSON do analizy.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
CancellationToken, który może służyć do anulowania operacji odczytu.
Zwraca
TValue reprezentacja wartości JSON.
Wyjątki
utf8Json lub jsonTypeInfo jest null.
Kod JSON jest nieprawidłowy, TValue nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Dotyczy
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Asynchronicznie odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego. Strumień zostanie odczytany do ukończenia.
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
Typ docelowy wartości JSON.
Parametry
- utf8Json
- Stream
Dane JSON do przeanalizowana.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas odczytywania.
- cancellationToken
- CancellationToken
Token, który może służyć do anulowania operacji odczytu.
Zwraca
TValue reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue nie jest zgodny z plikiem JSON.
-lub-
W strumieniu znajdują się pozostałe dane.
Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.
utf8Jsonjest null.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
