JsonSerializer.SerializeAsync 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
| SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
| SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
| SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) |
Asynchronicznie konwertuje wartość określonego typu na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w określonym strumieniu. |
| SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
| SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken) |
Asynchronicznie konwertuje wartość typu określonego przez ogólny parametr typu na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w strumieniu. |
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- value
- Object
Wartość do konwersji.
- inputType
- Type
Typ elementu do konwersji value .
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
- cancellationToken
- CancellationToken
Za CancellationToken pomocą tej funkcji można anulować operację zapisu.
Zwraca
Zadanie, które reprezentuje asynchroniczny zapis operacji.
Wyjątki
inputType nie jest zgodny z programem value.
utf8Json, inputTypelub context to null.
Nie ma żadnych zgodnych JsonConverter elementów inputType członkowskich ani ich serializacji.
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 Serialize(Stream, Object, Type, JsonSerializerContext)usługę .
Dotyczy
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- value
- Object
Wartość do konwersji.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
Za CancellationToken pomocą tej funkcji można anulować operację zapisu.
Zwraca
Zadanie, które reprezentuje asynchroniczny zapis operacji.
Wyjątki
utf8Json to null.
value nie jest zgodny z typem jsonTypeInfo.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Dotyczy
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)
Asynchronicznie konwertuje wartość określonego typu na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w określonym strumieniu.
public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- utf8Json
- Stream
Strumień UTF-8 do zapisu.
- value
- Object
Wartość do konwersji.
- inputType
- Type
Typ elementu do konwersji value .
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
- cancellationToken
- CancellationToken
Token, który może służyć do anulowania operacji zapisu.
Zwraca
Zadanie, które reprezentuje asynchroniczny zapis operacji.
Wyjątki
inputType nie jest zgodny z programem value.
utf8Json lub inputType to null.
Nie ma żadnych zgodnych JsonConverter elementów inputType 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 Serialize(Stream, Object, Type, JsonSerializerOptions)usługę .
Dotyczy
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream.
public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As TaskParametry typu
- TValue
Typ wartości do serializacji.
Parametry
- value
- TValue
Wartość do konwersji.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
- cancellationToken
- CancellationToken
Za CancellationToken pomocą tej funkcji można anulować operację zapisu.
Zwraca
Zadanie, które reprezentuje asynchroniczny zapis operacji.
Wyjątki
utf8Json to null.
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
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)
Asynchronicznie konwertuje wartość typu określonego przez ogólny parametr typu na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w strumieniu.
public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry typu
- TValue
Typ wartości do serializacji.
Parametry
- utf8Json
- Stream
Strumień UTF-8 do zapisu.
- value
- TValue
Wartość do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
- cancellationToken
- CancellationToken
Token, który może służyć do anulowania operacji zapisu.
Zwraca
Zadanie, które reprezentuje asynchroniczny zapis operacji.
Wyjątki
utf8Json to null.
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.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Dotyczy
Opinia
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ź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla