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 einer Instanz, die durch die |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(JsonNode, Type, JsonSerializerOptions) |
Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(JsonElement, Type, JsonSerializerContext) |
Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(JsonElement, Type, JsonSerializerOptions) |
Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(JsonDocument, Type, JsonSerializerContext) |
Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize(String, Type, JsonSerializerContext) |
Analysiert den Text, der einen einzelnen JSON-Wert in einem |
Deserialize(String, Type, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert in eine Instanz eines angegebenen Typs darstellt. |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext) |
Analysiert den Text, der einen einzelnen JSON-Wert in einem |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions) |
Analysiert den Text, der einen einzelnen JSON-Wert in eine Instanz eines angegebenen Typs darstellt. |
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions) |
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader und konvertiert ihn in eine Instanz eines angegebenen Typs. |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine Instanz eines angegebenen Typs darstellt. |
Deserialize(Stream, Type, JsonSerializerContext) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem |
Deserialize(Stream, Type, JsonSerializerOptions) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine instanz, die durch die |
Deserialize(JsonNode, JsonTypeInfo) |
Konvertiert die JsonNode, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die |
Deserialize(JsonElement, JsonTypeInfo) |
Konvertiert die JsonElement, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die |
Deserialize(JsonDocument, JsonTypeInfo) |
Konvertiert die JsonDocument, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die |
Deserialize(String, JsonTypeInfo) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine Instanz darstellt, die durch die |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions) |
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine Instanz des Typs, der durch einen generischen Typparameter angegeben wird. |
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>) |
Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Analysiert den Text, der einen einzelnen JSON-Wert in einem |
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>, 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<Byte>, JsonTypeInfo<TValue>) |
Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions) |
Parses the UTF-8 encoded text representing a single JSON value into an instance of the type specified by a generic type parameter. |
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Analysiert den Text, der einen einzelnen JSON-Wert in einem |
Deserialize(Stream, JsonTypeInfo)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einer Instanz, die durch die jsonTypeInfo
angegeben wird.
Der Stream wird nach 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
JSON-Daten, die analysiert werden sollen.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum 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 es gibt verbleibende Daten im Stream.
Gilt für:
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine 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 leser, der gelesen werden soll.
- returnType
- Type
Der Typ des objekts, in das konvertiert und 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
nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.
reader
verwendet nicht unterstützte Optionen.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode für die bereitgestellte context
hat keinen kompatiblen JsonTypeInfo für returnType
zurückgegeben.
Hinweise
Wenn die TokenType Eigenschaft von reader
PropertyName oder Noneist, wird der Leser durch einen Aufruf von Read() erweitert, um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode wird reader
am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions, die zum Erstellen der Instanz der Utf8JsonReader verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden AllowTrailingCommas, MaxDepthund CommentHandling beim Lesen 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 JsonNode, der 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 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context
gibt null
für den zu konvertierenden Typ zurück.
Gilt für:
Deserialize(JsonNode, Type, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den JsonNode, der 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 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Gilt für:
Deserialize(JsonElement, Type, JsonSerializerContext)
Konvertiert den JsonElement, der 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 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context
gibt null
für den zu konvertierenden Typ zurück.
Gilt für:
Deserialize(JsonElement, Type, JsonSerializerOptions)
Konvertiert den JsonElement, der 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 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Gilt für:
Deserialize(JsonDocument, Type, JsonSerializerContext)
Konvertiert den JsonDocument, der 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 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context
gibt null
für den zu konvertierenden Typ zurück.
Gilt für:
Deserialize(JsonDocument, Type, JsonSerializerOptions)
Konvertiert den JsonDocument, der 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 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Gilt für:
Deserialize(String, Type, JsonSerializerContext)
Analysiert den Text, der einen einzelnen JSON-Wert in einem returnType
darstellt.
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 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context
gibt null
für den zu konvertierenden Typ zurück.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
Gilt für:
Deserialize(String, Type, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert in eine Instanz eines angegebenen Typs darstellt.
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
Der zu analysierende JSON-Text.
- returnType
- Type
Der Typ des objekts, in das konvertiert und 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
Gilt für:
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
Analysiert den Text, der einen einzelnen JSON-Wert in einem returnType
darstellt.
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 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context
gibt null
für den zu konvertierenden Typ zurück.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
Gilt für:
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
Analysiert den Text, der einen einzelnen JSON-Wert in eine Instanz eines angegebenen Typs darstellt.
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>
Der zu analysierende JSON-Text.
- returnType
- Type
Der Typ des objekts, in das konvertiert und 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Spanne über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
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(Utf8JsonReader, Type, JsonSerializerOptions)
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader und konvertiert ihn in eine Instanz 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 Leser, aus dem der JSON-Code gelesen werden soll.
- returnType
- Type
Der Typ des objekts, in das konvertiert und zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens beim Lesen.
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 kompatibel.
-oder-
Ein Wert konnte nicht vom Leser gelesen werden.
reader
verwendet nicht unterstützte Optionen.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Hinweise
Wenn die TokenType Eigenschaft von reader
JsonTokenType.PropertyName oder JsonTokenType.Noneist, wird der Leser durch einen Aufruf von Utf8JsonReader.Read() erweitert, um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode wird reader
am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions, die zum Erstellen der Instanz der Utf8JsonReader verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthund JsonReaderOptions.CommentHandling beim Lesen verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
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 in eine Instanz eines angegebenen Typs darstellt.
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>
Der zu analysierende JSON-Text.
- returnType
- Type
Der Typ des objekts, in das konvertiert und 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Spanne über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Hinweise
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
Gilt für:
Deserialize(Stream, Type, JsonSerializerContext)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem returnType
darstellt.
Der Stream wird nach 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
JSON-Daten, die analysiert werden sollen.
- returnType
- Type
Der Typ des objekts, in das konvertiert und 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 kompatibel, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode für die bereitgestellte context
hat keinen kompatiblen JsonTypeInfo für returnType
zurückgegeben.
Gilt für:
Deserialize(Stream, Type, JsonSerializerOptions)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem returnType
darstellt.
Der Stream wird nach 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
JSON-Daten, die analysiert werden sollen.
- returnType
- Type
Der Typ des objekts, in das konvertiert und zurückgegeben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens beim Lesen.
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 kompatibel, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Gilt für:
Deserialize(Utf8JsonReader, JsonTypeInfo)
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine instanz, die durch die jsonTypeInfo
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 leser, der gelesen 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, jsonTypeInfo
nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.
reader
verwendet nicht unterstützte Optionen.
Hinweise
Wenn die TokenType Eigenschaft von reader
PropertyName oder Noneist, wird der Leser durch einen Aufruf von Read() erweitert, um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode wird reader
am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions, die zum Erstellen der Instanz der Utf8JsonReader verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden AllowTrailingCommas, MaxDepthund CommentHandling beim Lesen verwendet.
Gilt für:
Deserialize(JsonNode, JsonTypeInfo)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert die JsonNode, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfo
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(JsonElement, JsonTypeInfo)
Konvertiert die JsonElement, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfo
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(JsonDocument, JsonTypeInfo)
Konvertiert die JsonDocument, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfo
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(String, JsonTypeInfo)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfo
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 gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
Gilt für:
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfo
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 gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
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 in eine returnType
darstellt.
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 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
nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für returnType
oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode für die bereitgestellte 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 in eine Instanz darstellt, die durch die jsonTypeInfo
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 der Puffer enthält verbleibende Daten.
Gilt für:
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
Konvertiert den JsonElement, der 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
Konvertiert den JsonElement, der 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 zum zu konvertierenden Typ.
Gibt zurück
Eine TValue
Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo
ist null
.
TValue
ist nicht mit dem JSON kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine 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 leser, der gelesen werden soll.
- 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
nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.
reader
verwendet nicht unterstützte Optionen.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Wenn die TokenType Eigenschaft von reader
PropertyName oder Noneist, wird der Leser durch einen Aufruf von Read() erweitert, um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode wird reader
am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions, die zum Erstellen der Instanz der Utf8JsonReader verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden AllowTrailingCommas, MaxDepthund CommentHandling beim Lesen verwendet.
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 JsonNode, der 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 zum zu konvertierenden Typ.
Gibt zurück
Eine TValue
Darstellung des JSON-Werts.
Ausnahmen
jsonTypeInfo
ist null
.
TValue
ist nicht mit dem JSON kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
Liest einen JSON-Wert (einschließlich Objekte 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 Leser, aus dem der JSON-Code gelesen werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens beim Lesen.
Gibt zurück
Eine TValue
Darstellung des JSON-Werts.
Ausnahmen
Der JSON-Code ist ungültig.
-oder-
TValue
ist nicht mit dem JSON kompatibel.
-oder-
Ein Wert konnte nicht vom Leser gelesen werden.
reader
verwendet nicht unterstützte Optionen.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Wenn die TokenType Eigenschaft von reader
JsonTokenType.PropertyName oder JsonTokenType.Noneist, wird der Leser durch einen Aufruf von Utf8JsonReader.Read() erweitert, um den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode wird reader
am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
Die JsonReaderOptions, die zum Erstellen der Instanz der Utf8JsonReader verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthund JsonReaderOptions.CommentHandling beim Lesen verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
Gilt für:
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
Konvertiert den JsonDocument, der 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
- Quelle:
- JsonSerializer.Read.Node.cs
Konvertiert den JsonNode, der 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
Konvertiert den JsonDocument, der 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 kompatibel.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
Analysiert den Text, der einen einzelnen JSON-Wert in einem TValue
darstellt.
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>
JSON-Text, der analysiert werden soll.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ 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
Der zu analysierende JSON-Text.
- 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
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>
Der zu analysierende JSON-Text.
- 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Spanne über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
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<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 in eine TValue
darstellt.
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>
JSON-Text, der analysiert werden soll.
- 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
nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
- Quelle:
- JsonSerializer.Read.Span.cs
Parses the UTF-8 encoded text representing a single JSON value into an instance of the type specified by a generic type parameter.
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>
Der zu analysierende JSON-Text.
- 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Spanne über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
Gilt für:
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem TValue
darstellt.
Der Stream wird nach 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
JSON-Daten, die analysiert werden sollen.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum 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
nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(Stream, JsonSerializerOptions)
Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem TValue
darstellt.
Der Stream wird nach 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
JSON-Daten, die analysiert werden sollen.
- options
- JsonSerializerOptions
Optionen zum Steuern des Verhaltens beim Lesen.
Gibt zurück
Eine TValue
Darstellung des JSON-Werts.
Ausnahmen
utf8Json
ist null
.
Der JSON-Code ist ungültig, TValue
nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Gilt für:
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
Analysiert den Text, der einen einzelnen JSON-Wert in einem TValue
darstellt.
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
JSON-Text, der analysiert werden soll.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum 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 kompatibel.
-oder-
Es gibt verbleibende Daten in der Zeichenfolge über einen einzelnen JSON-Wert hinaus.
Es gibt keine kompatiblen JsonConverter für TValue
oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Methoden, da die Implementierung utf-8 nativ verwendet.