JsonSerializer.Deserialize Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Überlädt

Deserialize(Stream, JsonTypeInfo)	Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einer Instanz, die durch die jsonTypeInfoangegeben wird. Der Stream wird nach Abschluss gelesen.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine returnType.
Deserialize(JsonNode, Type, JsonSerializerContext)	Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(JsonElement, Type, JsonSerializerContext)	Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen returnType.
Deserialize(String, Type, JsonSerializerContext)	Analysiert den Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt.
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 returnTypedarstellt.
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 returnTypedarstellt. Der Stream wird nach Abschluss gelesen.
Deserialize(Stream, Type, JsonSerializerOptions)	Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt. Der Stream wird nach Abschluss gelesen.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(JsonNode, JsonTypeInfo)	Konvertiert die JsonNode, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(JsonElement, JsonTypeInfo)	Konvertiert die JsonElement, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(JsonDocument, JsonTypeInfo)	Konvertiert die JsonDocument, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(String, JsonTypeInfo)	Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben wird.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine returnTypedarstellt.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine Instanz darstellt, die durch die jsonTypeInfoangegeben wird.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Konvertiert den JsonElement, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine TValue.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen TValue.
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 TValue.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Konvertiert den JsonNode, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Konvertiert den JsonDocument, der einen einzelnen JSON-Wert darstellt, in einen TValue.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analysiert den Text, der einen einzelnen JSON-Wert in einem TValuedarstellt.
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 TValuedarstellt.
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 TValuedarstellt. Der Stream wird nach Abschluss gelesen.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem TValuedarstellt. Der Stream wird nach Abschluss gelesen.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analysiert den Text, der einen einzelnen JSON-Wert in einem TValuedarstellt.

Deserialize(Stream, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Stream.cs

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert darstellt, in einer Instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

utf8Json oder jsonTypeInfo ist null.

JsonException

Der JSON-Code ist ungültig, oder es gibt verbleibende Daten im Stream.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.Utf8JsonReader.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType oder context ist null.

JsonException

Der JSON-Code ist ungültig, returnType nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.

ArgumentException

reader verwendet nicht unterstützte Optionen.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode für die bereitgestellte context hat keinen kompatiblen JsonTypeInfo für returnTypezurückgegeben.

Hinweise

Wenn die TokenType Eigenschaft von readerPropertyName 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.

Deserialize(JsonNode, Type, JsonSerializerContext)

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

node

JsonNode

Die zu konvertierende JsonNode.

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

-oder-

context ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.

Deserialize(JsonNode, Type, JsonSerializerOptions)

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

node

JsonNode

Die zu konvertierende JsonNode.

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

JsonException

returnType ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Deserialize(JsonElement, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.Element.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

-oder-

context ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Element.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

JsonException

returnType ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.Document.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

document ist null.

-oder-

returnType ist null.

-oder-

context ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Document.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

document oder returnType ist null.

JsonException

returnType ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Deserialize(String, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt.

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json oder returnType ist null.

-oder-

context ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

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.

Deserialize(String, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.String.cs

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);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json oder returnType ist null.

JsonException

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.

NotSupportedException

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt.

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json oder returnType ist null.

-oder-

context ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.String.cs

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

JsonException

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.

NotSupportedException

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.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Utf8JsonReader.cs

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);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

JsonException

Der JSON-Code ist ungültig.

-oder-

returnType ist nicht mit dem JSON kompatibel.

-oder-

Ein Wert konnte nicht vom Leser gelesen werden.

ArgumentException

reader verwendet nicht unterstützte Optionen.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Hinweise

Wenn die TokenType Eigenschaft von readerJsonTokenType.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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Hinweise

Weitere Informationen finden Sie unter How to serialize and deserialize JSON.

Deserialize(Stream, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.Stream.cs

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt. 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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

utf8Json, returnTypeoder context ist null.

JsonException

Der JSON-Code ist ungültig, der returnType ist nicht mit dem JSON kompatibel, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode für die bereitgestellte context hat keinen kompatiblen JsonTypeInfo für returnTypezurückgegeben.

Deserialize(Stream, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Stream.cs

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem returnTypedarstellt. 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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

utf8Json oder returnType ist null.

JsonException

Der JSON-Code ist ungültig, der returnType ist nicht mit dem JSON kompatibel, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

Deserialize(Utf8JsonReader, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Utf8JsonReader.cs

Liest einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem bereitgestellten Reader in eine instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

JsonException

Der JSON-Code ist ungültig, jsonTypeInfo nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.

ArgumentException

reader verwendet nicht unterstützte Optionen.

Hinweise

Wenn die TokenType Eigenschaft von readerPropertyName 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.

Deserialize(JsonNode, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Node.cs

Konvertiert die JsonNode, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben 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

node

JsonNode

Die zu konvertierende JsonNode.

jsonTypeInfo

JsonTypeInfo

Metadaten zum zu konvertierenden Typ.

Gibt zurück

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

Deserialize(JsonElement, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Element.cs

Konvertiert die JsonElement, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

Deserialize(JsonDocument, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Document.cs

Konvertiert die JsonDocument, die einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

document ist null.

-oder-

jsonTypeInfo ist null.

Deserialize(String, JsonTypeInfo)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json ist null.

-oder-

jsonTypeInfo ist null.

JsonException

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.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert darstellt, in eine Instanz, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

JsonException

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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Read.Span.cs

Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine returnTypedarstellt.

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

Object

Eine returnType Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

returnType ist null.

JsonException

Der JSON-Code ist ungültig, returnType nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für returnType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode für die bereitgestellte context hat keinen kompatiblen JsonTypeInfo für returnTypezurückgegeben.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Quelle:

JsonSerializer.Read.Span.cs

Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine Instanz darstellt, die durch die jsonTypeInfoangegeben 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

Object

Eine jsonTypeInfo Darstellung des JSON-Werts.

Ausnahmen

JsonException

Der JSON-Code ist ungültig, oder der Puffer enthält verbleibende Daten.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Element.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.Element.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.Utf8JsonReader.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

Der JSON-Code ist ungültig, TValue nicht mit dem JSON kompatibel ist oder ein Wert nicht vom Leser gelesen werden konnte.

ArgumentException

reader verwendet nicht unterstützte Optionen.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Hinweise

Wenn die TokenType Eigenschaft von readerPropertyName 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.

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

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

node

JsonNode

Die zu konvertierende JsonNode.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadaten zum zu konvertierenden Typ.

Gibt zurück

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Utf8JsonReader.cs

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);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

Der JSON-Code ist ungültig.

-oder-

TValue ist nicht mit dem JSON kompatibel.

-oder-

Ein Wert konnte nicht vom Leser gelesen werden.

ArgumentException

reader verwendet nicht unterstützte Optionen.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Hinweise

Wenn die TokenType Eigenschaft von readerJsonTokenType.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.

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.Document.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

document ist null.

-oder-

jsonTypeInfo ist null.

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

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

node

JsonNode

Die zu konvertierende JsonNode.

options

JsonSerializerOptions

Optionen zum Steuern des Verhaltens während der Analyse.

Gibt zurück

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Document.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

document ist null.

JsonException

TValue ist nicht mit dem JSON kompatibel.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert in einem TValuedarstellt.

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json ist null.

-oder-

jsonTypeInfo ist null.

JsonException

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.

NotSupportedException

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.

Deserialize<TValue>(String, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.String.cs

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);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json ist null.

JsonException

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.

NotSupportedException

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.

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.String.cs

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

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.

NotSupportedException

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.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.Span.cs

Analysiert den UTF-8-codierten Text, der einen einzelnen JSON-Wert in eine TValuedarstellt.

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

Der JSON-Code ist ungültig, TValue nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

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);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

JsonException

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.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Hinweise

Weitere Informationen finden Sie unter How to serialize and deserialize JSON.

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.Stream.cs

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem TValuedarstellt. 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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

utf8Json oder jsonTypeInfo ist null.

JsonException

Der JSON-Code ist ungültig, TValue nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Quelle:

JsonSerializer.Read.Stream.cs

Liest den UTF-8-codierten Text, der einen einzelnen JSON-Wert in einem TValuedarstellt. 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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

utf8Json ist null.

JsonException

Der JSON-Code ist ungültig, TValue nicht mit dem JSON kompatibel ist, oder es gibt verbleibende Daten im Stream.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Read.String.cs

Analysiert den Text, der einen einzelnen JSON-Wert in einem TValuedarstellt.

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

TValue

Eine TValue Darstellung des JSON-Werts.

Ausnahmen

ArgumentNullException

json ist null.

-oder-

jsonTypeInfo ist null.

JsonException

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.

NotSupportedException

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.