JsonSerializer.Deserialize 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
| Deserialize(Stream, JsonTypeInfo) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in einen |
| Deserialize(Utf8JsonReader, Type, JsonSerializerOptions) |
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader und konvertiert ihn in einen instance eines angegebenen Typs. |
| Deserialize(JsonNode, Type, JsonSerializerOptions) |
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(JsonElement, Type, JsonSerializerContext) |
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(JsonElement, Type, JsonSerializerOptions) |
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(JsonDocument, Type, JsonSerializerContext) |
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(String, Type, JsonSerializerContext) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(String, Type, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs. |
| Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs. |
| Deserialize(JsonNode, Type, JsonSerializerContext) |
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs. |
| Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(String, JsonTypeInfo) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(JsonDocument, JsonTypeInfo) |
Konvertiert die , die JsonDocument einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(JsonNode, JsonTypeInfo) |
Konvertiert die , die JsonNode einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize(Utf8JsonReader, JsonTypeInfo) |
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in eine instance, die |
| Deserialize(Stream, Type, JsonSerializerOptions) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(Stream, Type, JsonSerializerContext) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize(JsonElement, JsonTypeInfo) |
Konvertiert die , die JsonElement einen einzelnen JSON-Wert darstellt, in eine instance, die |
| Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in einen |
| Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>) |
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions) |
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. |
| Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. |
| Deserialize<TValue>(String, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. |
| Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. |
| Deserialize<TValue>(Stream, JsonTypeInfo<TValue>) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(Stream, JsonSerializerOptions) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen |
| Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(Stream, JsonTypeInfo)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die jsonTypeInfodurch angegeben wird.
Der Stream wird bis zum Abschluss gelesen.
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- utf8Json
- Stream
Zu analysierende JSON-Daten.
- jsonTypeInfo
- JsonTypeInfo
Metadaten über den zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
utf8Json oder jsonTypeInfo ist null.
Der JSON-Code ist ungültig, oder der Stream enthält verbleibende Daten.
Gilt für:
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in einen returnType.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- reader
- Utf8JsonReader
Der Reader zum Lesen.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType oder context ist null.
Der JSON-Code ist ungültig, returnType ist nicht mit dem JSON-Code kompatibel, oder ein Wert konnte nicht aus dem Reader gelesen werden.
reader verwendet nicht unterstützte Optionen.
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 returnTypezurückgegeben.
Hinweise
Wenn die TokenType -Eigenschaft von reader oder NoneistPropertyName, wird der Reader durch einen Aufruf von erweitert, Read() um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird am letzten Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Reader auf den Zustand zurückgesetzt, in dem er sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Anforderung des Aufrufers gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions , die zum Erstellen der instance von Utf8JsonReader verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. AllowTrailingCommasDaher werden , MaxDepthund CommentHandling beim Lesen verwendet.
Gilt für:
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader und konvertiert ihn in einen instance eines angegebenen Typs.
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> objPublic Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- reader
- Utf8JsonReader
Der Reader, aus dem der JSON-Inhalt gelesen werden soll.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisiererverhaltens während des Lesevorgangs.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist null.
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es konnte kein Wert aus dem Reader gelesen werden.
reader verwendet nicht unterstützte Optionen.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Hinweise
Wenn die TokenType -Eigenschaft von reader oder JsonTokenType.NoneistJsonTokenType.PropertyName, wird der Reader durch einen Aufruf von erweitert, Utf8JsonReader.Read() um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Reader auf den Zustand zurückgesetzt, in dem er sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Anforderung des Aufrufers gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions , die zum Erstellen der instance von Utf8JsonReader verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. JsonReaderOptions.AllowTrailingCommasDaher werden , JsonReaderOptions.MaxDepthund JsonReaderOptions.CommentHandling beim Lesen verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize(JsonNode, Type, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen returnType.
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize(JsonElement, Type, JsonSerializerContext)
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- element
- JsonElement
Die zu konvertierende JsonElement.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der angegebenen context gibt für den zu konvertierenden Typ zurück null .
Gilt für:
Deserialize(JsonElement, Type, JsonSerializerOptions)
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen returnType.
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- element
- JsonElement
Die zu konvertierende JsonElement.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist null
returnType ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize(JsonDocument, Type, JsonSerializerContext)
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- document
- JsonDocument
Die zu konvertierende JsonDocument.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der angegebenen context gibt für den zu konvertierenden Typ zurück null .
Gilt für:
Deserialize(JsonDocument, Type, JsonSerializerOptions)
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen returnType.
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- document
- JsonDocument
Die zu konvertierende JsonDocument.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
document oder returnType ist null.
returnType ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize(String, Type, JsonSerializerContext)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- json
- String
JSON-Text, der analysiert werden soll.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der angegebenen context gibt für den zu konvertierenden Typ zurück null .
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize(String, Type, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs.
public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> objPublic Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- json
- String
Ruft den zu analysierenden JSON-Text ab.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
json oder returnType ist null.
Der JSON-Code ist ungültig.
- oder -
TValue ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As ObjectParameter
- json
- ReadOnlySpan<Char>
JSON-Text, der analysiert werden soll.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der bereitgestellten context gibt für den zu konvertierenden Typ zurück null .
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs.
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- json
- ReadOnlySpan<Char>
Ruft den zu analysierenden JSON-Text ab.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist null.
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten im Bereich über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung einer UTF-16-Spanne ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize(JsonNode, Type, JsonSerializerContext)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den, der JsonNode einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der bereitgestellten context gibt für den zu konvertierenden Typ zurück null .
Gilt für:
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz eines angegebenen Typs.
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> objPublic Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- utf8Json
- ReadOnlySpan<Byte>
Ruft den zu analysierenden JSON-Text ab.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist null.
Der JSON-Code ist ungültig.
- oder -
returnType ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten im Bereich über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Hinweise
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen returnType.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As ObjectParameter
- utf8Json
- ReadOnlySpan<Byte>
JSON-Text, der analysiert werden soll.
- returnType
- Type
Der Typ des Objekts, in das konvertiert und das zurückgegeben werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
returnType ist null
Der JSON-Code ist ungültig, returnType ist nicht mit dem JSON-Code kompatibel, oder es befinden sich 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 angegebene context hat keinen kompatiblen JsonTypeInfo für returnTypezurückgegeben.
Gilt für:
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die jsonTypeInfodurch angegeben wird.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- utf8Json
- ReadOnlySpan<Byte>
JSON-Text, der analysiert werden soll.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig, oder es befinden sich verbleibende Daten im Puffer.
Gilt für:
Deserialize(String, JsonTypeInfo)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die jsonTypeInfodurch angegeben wird.
public:
static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- json
- String
JSON-Text, der analysiert werden soll.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize(JsonDocument, JsonTypeInfo)
Konvertiert den, der JsonDocument einen einzelnen JSON-Wert darstellt, in einen instance, der jsonTypeInfodurch angegeben wird.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- document
- JsonDocument
Die zu konvertierende JsonDocument.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
Gilt für:
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine instance, die jsonTypeInfodurch angegeben wird.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- json
- ReadOnlySpan<Char>
JSON-Text, der analysiert werden soll.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo ist null.
Der JSON-Code ist ungültig.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize(JsonNode, JsonTypeInfo)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den, der JsonNode einen einzelnen JSON-Wert darstellt, in einen instance, der jsonTypeInfodurch angegeben wird.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo ist null
Gilt für:
Deserialize(Utf8JsonReader, JsonTypeInfo)
Liest einen JSON-Wert (einschließlich -Objekten oder Arrays) aus dem bereitgestellten Reader in eine instance, die jsonTypeInfodurch angegeben wird.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> objPublic Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- reader
- Utf8JsonReader
Der Reader zum Lesen.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig, jsonTypeInfo ist nicht mit dem JSON-Code kompatibel, oder ein Wert konnte nicht aus dem Reader gelesen werden.
reader verwendet nicht unterstützte Optionen.
Hinweise
Wenn die TokenType Eigenschaft von reader oder NoneistPropertyName, wird der Leser durch einen Aufruf von erweitert, um Read() den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird am letzten Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem er sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Anforderung des Aufrufers gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions zum Erstellen der instance von Utf8JsonReader verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. AllowTrailingCommasDaher werden , MaxDepthund CommentHandling beim Lesen verwendet.
Gilt für:
Deserialize(Stream, Type, JsonSerializerOptions)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Der Stream wird bis zum Abschluss gelesen.
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> objPublic Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As ObjectParameter
- utf8Json
- Stream
Zu analysierende 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.
Gibt zurück
Eine returnType-Darstellung des JSON-Werts.
Ausnahmen
utf8Json oder returnType ist null.
Der JSON-Code ist ungültig, der returnType ist nicht mit dem JSON-Code kompatibel, oder es befinden sich verbleibende Daten im Stream.
Es ist keine kompatible JsonConverter-Klasse für returnType oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize(Stream, Type, JsonSerializerContext)
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::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> objPublic Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As ObjectParameter
- 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.
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 befinden sich 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 angegebene context hat keinen kompatiblen JsonTypeInfo für returnTypezurückgegeben.
Gilt für:
Deserialize(JsonElement, JsonTypeInfo)
Konvertiert den, der JsonElement einen einzelnen JSON-Wert darstellt, in einen instance, der jsonTypeInfodurch angegeben wird.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As ObjectParameter
- element
- JsonElement
Die zu konvertierende JsonElement.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine jsonTypeInfo-Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo ist null
Gilt für:
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
Liest einen JSON-Wert (einschließlich -Objekte oder Arrays) aus dem bereitgestellten Reader in einen TValue.
public:
generic <typename TValue>
static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- reader
- Utf8JsonReader
Der Reader zum Lesen.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig, TValue ist nicht mit dem JSON-Code kompatibel, oder ein Wert konnte nicht aus dem Reader gelesen werden.
reader verwendet nicht unterstützte Optionen.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Wenn die TokenType Eigenschaft von reader oder NoneistPropertyName, wird der Leser durch einen Aufruf von erweitert, um Read() den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird am letzten Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem er sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Anforderung des Aufrufers gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions zum Erstellen der instance von Utf8JsonReader verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. AllowTrailingCommasDaher werden , MaxDepthund CommentHandling beim Lesen verwendet.
Gilt für:
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
Konvertiert den, der JsonDocument einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- document
- JsonDocument
Die zu konvertierende JsonDocument.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
Liest einen JSON-Wert (einschließlich Objekten oder Arrays) aus dem bereitgestellten Reader in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValuePublic Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Zieltyp des JSON-Werts.
Parameter
- reader
- Utf8JsonReader
Der Reader, aus dem der JSON-Inhalt gelesen werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisiererverhaltens während des Lesevorgangs.
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 konnte kein Wert aus dem Reader gelesen werden.
reader verwendet nicht unterstützte Optionen.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Wenn die TokenType Eigenschaft von reader oder JsonTokenType.NoneistJsonTokenType.PropertyName, wird der Leser durch einen Aufruf von erweitert, um Utf8JsonReader.Read() den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird am letzten Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem er sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Anforderung des Aufrufers gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions zum Erstellen der instance von Utf8JsonReader verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. JsonReaderOptions.AllowTrailingCommasDaher werden , JsonReaderOptions.MaxDepthund JsonReaderOptions.CommentHandling beim Lesen verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo ist null
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den , der JsonNode einen einzelnen JSON-Wert darstellt, in einen TValue.
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- element
- JsonElement
Die zu konvertierende JsonElement.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo ist null
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
Konvertiert den , der JsonElement einen einzelnen JSON-Wert darstellt, in einen TValue.
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- element
- JsonElement
Die zu konvertierende JsonElement.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
Konvertiert den , der JsonDocument einen einzelnen JSON-Wert darstellt, in einen TValue.
public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- document
- JsonDocument
Die zu konvertierende JsonDocument.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
document ist null
TValue ist nicht mit dem JSON-Code kompatibel.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.
public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- json
- ReadOnlySpan<Char>
Ruft den zu analysierenden JSON-Text ab.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
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 sind noch Daten im Bereich über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung einer UTF-16-Span ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize<TValue>(String, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.
public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValuePublic Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Zieltyp des JSON-Werts.
Parameter
- json
- String
Ruft den zu analysierenden JSON-Text ab.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
json ist null.
Der JSON-Code ist ungültig.
- oder -
TValue ist nicht mit dem JSON-Code kompatibel.
- oder -
Es sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- json
- ReadOnlySpan<Char>
Zu analysierender JSON-Text.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
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 sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Zu analysierender JSON-Text.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
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.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird.
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValuePublic Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Zieltyp des UTF-8-codierten Texts.
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Ruft den zu analysierenden JSON-Text ab.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während der Analyse.
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 sind noch Daten im Bereich über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Der Stream wird bis zum Abschluss gelesen.
public:
generic <typename TValue>
static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- 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.
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.
Gilt für:
Deserialize<TValue>(Stream, JsonSerializerOptions)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Der Stream wird bis zum Abschluss gelesen.
public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'ValuePublic Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- utf8Json
- Stream
Zu analysierende JSON-Daten.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens während des Lesevorgangs.
Gibt zurück
Eine TValue-Darstellung des JSON-Werts.
Ausnahmen
utf8Json 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.
Gilt für:
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in einen TValue.
public:
generic <typename TValue>
static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'ValuePublic Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValueTypparameter
- TValue
Der Typ, in den der JSON-Wert deserialisiert werden soll.
Parameter
- json
- String
Zu analysierender JSON-Text.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
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 sind noch Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus vorhanden.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung nativ UTF-8 verwendet.
Gilt für:
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für