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, Type, JsonSerializerContext, CancellationToken) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego |
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Asynchronicznie odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu. Strumień zostanie odczytany do ukończenia. |
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Asynchronicznie odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego. Strumień zostanie odczytany do ukończenia. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie 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 analizowania.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
- cancellationToken
- CancellationToken
Za CancellationToken pomocą tej operacji można anulować operację odczytu.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
utf8Json
, returnType
lub context
to null
.
Kod JSON jest nieprawidłowy, element returnType
nie jest zgodny z plikiem JSON lub w usłudze Stream znajdują się pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podana context
nie zwróciła zgodnego JsonTypeInfo dla returnType
metody .
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Deserialize(Stream, Type, JsonSerializerContext)usługę .
Dotyczy
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego jsonTypeInfo
przez obiekt .
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 analizowania.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
Za CancellationToken pomocą tej operacji można anulować operację odczytu.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
to null
.
Kod JSON jest nieprawidłowy lub gdy istnieją pozostałe dane w usłudze Stream.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Dotyczy
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Asynchronicznie odczytuje zakodowany w formacie UTF-8 tekst 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 analizowania.
- 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
Reprezentacja returnType
wartości JSON.
Wyjątki
utf8Json
lub returnType
to null
.
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
W strumieniu znajdują się pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Deserialize(Stream, Type, JsonSerializerOptions)usługę .
Dotyczy
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie 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 analizowania.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
Element CancellationToken , który może służyć do anulowania operacji odczytu.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
to null
.
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub w usłudze Stream istnieją pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Dotyczy
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Asynchronicznie odczytuje zakodowany w formacie UTF-8 tekst 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 analizowania.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas odczytywania.
- cancellationToken
- CancellationToken
Token, który może służyć do anulowania operacji odczytu.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
W strumieniu znajdują się pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
utf8Json
to null
.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla