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 jsonTypeInfo
durch 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 -> obj
Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- 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 -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- 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 returnType
zurü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 -> obj
Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- 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 Object
Parameter
- 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 Object
Parameter
- 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 Object
Parameter
- 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 Object
Parameter
- 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 Object
Parameter
- 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 -> obj
Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- 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 -> obj
Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- 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 -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object
Parameter
- 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 -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- 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 Object
Parameter
- 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 -> obj
Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- 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 -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object
Parameter
- 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 returnType
zurü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 jsonTypeInfo
durch 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 -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- 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 jsonTypeInfo
durch 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 -> obj
Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- 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 jsonTypeInfo
durch 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 Object
Parameter
- 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 jsonTypeInfo
durch 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 -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- 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 jsonTypeInfo
durch 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 Object
Parameter
- 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 jsonTypeInfo
durch 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 -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- 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 -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- 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 -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As 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.
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 returnType
zurückgegeben.
Gilt für:
Deserialize(JsonElement, JsonTypeInfo)
Konvertiert den, der JsonElement einen einzelnen JSON-Wert darstellt, in einen instance, der jsonTypeInfo
durch 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 Object
Parameter
- 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> -> 'Value
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Typparameter
- 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 TValue
Typparameter
- 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 -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Typparameter
- 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 TValue
Typparameter
- 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 TValue
Typparameter
- 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 TValue
Typparameter
- 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 TValue
Typparameter
- 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 TValue
Typparameter
- 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 -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue
Typparameter
- 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 -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Typparameter
- 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> -> 'Value
Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Typparameter
- 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> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Typparameter
- 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 -> 'Value
Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Typparameter
- 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> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As 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.
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 -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue
Typparameter
- 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> -> 'Value
Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Typparameter
- 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
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