JsonSerializer.SerializeAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .Stream |
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .Stream |
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken) |
Konvertiert den Wert eines angegebenen Typs asynchron in UTF-8-codierten JSON-Text und schreibt ihn in den angegebenen Datenstrom. |
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .Stream |
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken) |
Konvertiert einen Wert eines Typs, der durch einen generischen Typparameter angegeben wird, asynchron in UTF-8-codierten JSON-Text und schreibt ihn in einen Datenstrom. |
SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .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.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value
-Elements, das konvertiert werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
- cancellationToken
- CancellationToken
Der CancellationToken , der zum Abbrechen des Schreibvorgangs verwendet werden kann.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
inputType
ist nicht mit value
kompatibel.
utf8Json
, inputType
oder context
ist null
.
Es ist keine kompatible JsonConverter-Klasse für inputType
oder die serialisierbaren Member vorhanden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Serialize(Stream, Object, Type, JsonSerializerContext).
Gilt für:
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .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.Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- value
- Object
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo
Metadaten über den zu konvertierenden Typ.
- cancellationToken
- CancellationToken
Der CancellationToken , der zum Abbrechen des Schreibvorgangs verwendet werden kann.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
utf8Json
ist null
value
stimmt nicht mit dem Typ von jsonTypeInfo
überein.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Gilt für:
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)
Konvertiert den Wert eines angegebenen Typs asynchron in UTF-8-codierten JSON-Text und schreibt ihn in den angegebenen Datenstrom.
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.Task
Public Shared Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Parameter
- utf8Json
- Stream
Der UTF-8-Datenstrom, in den geschrieben werden soll.
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value
-Elements, das konvertiert werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
- cancellationToken
- CancellationToken
Ein Token, das verwendet werden kann, um den Schreibvorgang abzubrechen.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
inputType
ist nicht mit value
kompatibel.
utf8Json
oder inputType
ist null
.
Es ist keine kompatible JsonConverter-Klasse für inputType
oder die serialisierbaren Member vorhanden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Serialize(Stream, Object, Type, JsonSerializerOptions).
Gilt für:
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .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.Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task
Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- value
- TValue
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
- cancellationToken
- CancellationToken
Der CancellationToken , der zum Abbrechen des Schreibvorgangs verwendet werden kann.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
utf8Json
ist null
.
Es ist keine kompatible JsonConverter-Klasse für TValue
oder die serialisierbaren Member vorhanden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Gilt für:
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)
Konvertiert einen Wert eines Typs, der durch einen generischen Typparameter angegeben wird, asynchron in UTF-8-codierten JSON-Text und schreibt ihn in einen Datenstrom.
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.Task
Public Shared Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task
Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- utf8Json
- Stream
Der UTF-8-Datenstrom, in den geschrieben werden soll.
- value
- TValue
Der zu konvertierende Wert.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
- cancellationToken
- CancellationToken
Ein Token, das verwendet werden kann, um den Schreibvorgang abzubrechen.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
utf8Json
ist null
.
Es ist keine kompatible JsonConverter-Klasse für TValue
oder die serialisierbaren Member vorhanden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für