JsonSerializer.DeserializeAsync 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
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die |
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz eines angegebenen Typs. Der Datenstrom wird vollständig gelesen. |
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Kiest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. Der Datenstrom wird vollständig gelesen. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen returnType
.
Der Stream wird bis zum Abschluss gelesen.
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)
Parameter
- utf8Json
- Stream
Zu analysierende JSON-Daten.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
- cancellationToken
- CancellationToken
Die CancellationToken , die verwendet werden kann, um den Lesevorgang abzubrechen.
Gibt zurück
Eine returnType
-Darstellung des JSON-Werts.
Ausnahmen
utf8Json
, returnType
oder context
ist null
.
Der JSON-Code ist ungültig, der returnType
ist nicht mit dem JSON-Code kompatibel, oder es gibt verbleibende Daten im Stream.
Es ist keine kompatible JsonConverter-Klasse für returnType
oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode für die bereitgestellte context
hat keine kompatible JsonTypeInfo für returnType
zurückgegeben.
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 Deserialize(Stream, Type, JsonSerializerContext).
Gilt für:
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die jsonTypeInfo
durch angegeben wird.
Der Stream wird bis zum Abschluss gelesen.
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)
Parameter
- utf8Json
- Stream
Zu analysierende JSON-Daten.
- jsonTypeInfo
- JsonTypeInfo
Metadaten über den zu konvertierenden Typ.
- cancellationToken
- CancellationToken
Die CancellationToken , die verwendet werden kann, um den Lesevorgang abzubrechen.
Gibt zurück
Eine jsonTypeInfo
-Darstellung des JSON-Werts.
Ausnahmen
utf8Json
oder jsonTypeInfo
ist null
.
Der JSON-Code ist ungültig, oder wenn im Stream verbleibende Daten vorhanden sind.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Gilt für:
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz eines angegebenen Typs. Der Datenstrom wird vollständig gelesen.
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)
Parameter
- utf8Json
- Stream
Die zu analysierenden JSON-Daten.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während des Lesevorgangs.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um den Lesevorgang abzubrechen.
Gibt zurück
Eine returnType
-Darstellung des JSON-Werts.
Ausnahmen
utf8Json
oder returnType
ist null
.
Der JSON-Code ist ungültig.
- oder -
TValue
ist nicht mit dem JSON-Code kompatibel.
- oder -
Es verbleiben Daten im Datenstrom.
Es ist keine kompatible JsonConverter-Klasse für returnType
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 Deserialize(Stream, Type, JsonSerializerOptions).
Gilt für:
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen TValue
.
Der Stream wird bis zum Abschluss gelesen.
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)
Typparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- utf8Json
- Stream
Zu analysierende JSON-Daten.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
- cancellationToken
- CancellationToken
Die CancellationToken , die verwendet werden kann, um den Lesevorgang abzubrechen.
Gibt zurück
Eine TValue
-Darstellung des JSON-Werts.
Ausnahmen
utf8Json
oder jsonTypeInfo
ist null
.
Der JSON-Code ist ungültig, TValue
ist nicht mit dem JSON-Code kompatibel, oder der Stream enthält verbleibende Daten.
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:
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Kiest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, asynchron in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. Der Datenstrom wird vollständig gelesen.
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)
Typparameter
- TValue
Der Zieltyp des JSON-Werts.
Parameter
- utf8Json
- Stream
Die zu analysierenden JSON-Daten.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während des Lesevorgangs.
- cancellationToken
- CancellationToken
Ein Token, das verwendet werden kann, um den Lesevorgang abzubrechen.
Gibt zurück
Eine TValue
-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
TValue
ist nicht mit dem JSON-Code kompatibel.
- oder -
Es verbleiben Daten im Datenstrom.
Es ist keine kompatible JsonConverter-Klasse für TValue
oder die serialisierbaren Member vorhanden.
utf8Json
ist null
.
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