JsonSerializer.Deserialize Metoda

Reference

Definice

Obor názvů:: System.Text.Json

Sestavení:: System.Text.Json.dll

Balíček:: System.Text.Json v8.0.5

Balíček:: System.Text.Json v9.0.0-rc.2.24473.5

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přetížení

Deserialize(Stream, JsonTypeInfo)	Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené `jsonTypeInfo`. Stream se přečte do dokončení.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Čte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do `returnType`.
Deserialize(JsonNode, Type, JsonSerializerContext)	Převede JsonNode představující jednu hodnotu JSON na `returnType`.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Převede JsonNode představující jednu hodnotu JSON na `returnType`.
Deserialize(JsonElement, Type, JsonSerializerContext)	Převede JsonElement představující jednu hodnotu JSON na `returnType`.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Převede JsonElement představující jednu hodnotu JSON na `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Převede JsonDocument představující jednu hodnotu JSON na `returnType`.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Převede JsonDocument představující jednu hodnotu JSON na `returnType`.
Deserialize(String, Type, JsonSerializerContext)	Parsuje text představující jednu hodnotu JSON do `returnType`.
Deserialize(String, Type, JsonSerializerOptions)	Parsuje text představující jednu hodnotu JSON do instance zadaného typu.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Parsuje text představující jednu hodnotu JSON do `returnType`.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Parsuje text představující jednu hodnotu JSON do instance zadaného typu.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky a převede ji na instanci zadaného typu.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do instance zadaného typu.
Deserialize(Stream, Type, JsonSerializerContext)	Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do `returnType`. Stream se přečte do dokončení.
Deserialize(Stream, Type, JsonSerializerOptions)	Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do `returnType`. Stream se přečte do dokončení.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do instance určené `jsonTypeInfo`.
Deserialize(JsonNode, JsonTypeInfo)	Převede JsonNode představující jednu hodnotu JSON na instanci určenou `jsonTypeInfo`.
Deserialize(JsonElement, JsonTypeInfo)	Převede JsonElement představující jednu hodnotu JSON na instanci určenou `jsonTypeInfo`.
Deserialize(JsonDocument, JsonTypeInfo)	Převede JsonDocument představující jednu hodnotu JSON na instanci určenou `jsonTypeInfo`.
Deserialize(String, JsonTypeInfo)	Parsuje text představující jednu hodnotu JSON do instance určené `jsonTypeInfo`.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Parsuje text představující jednu hodnotu JSON do instance určené `jsonTypeInfo`.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do `returnType`.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Parsuje zakódovaný text UTF-8 představující jednu hodnotu JSON do instance určené `jsonTypeInfo`.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Převede JsonElement představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Převede JsonElement představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Čte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do `TValue`.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Převede JsonNode představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do instance typu určeného parametrem obecného typu.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Převede JsonDocument představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Převede JsonNode představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Převede JsonDocument představující jednu hodnotu JSON na `TValue`.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Parsuje text představující jednu hodnotu JSON do `TValue`.
Deserialize<TValue>(String, JsonSerializerOptions)	Analyzuje text představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analyzuje text představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do `TValue`.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do `TValue`. Stream se přečte do dokončení.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do `TValue`. Stream se přečte do dokončení.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Parsuje text představující jednu hodnotu JSON do `TValue`.

Deserialize(Stream, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do instance určené jsonTypeInfo. Stream se přečte do dokončení.

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

Parametry

utf8Json: Stream

Data JSON, která se mají analyzovat

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

utf8Json nebo jsonTypeInfo je null.

JsonException

JSON je neplatný nebo ve streamu jsou zbývající data.

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Čte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do 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

Parametry

reader: Utf8JsonReader

Čtenář, který se má přečíst.

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType nebo context je null.

JsonException

Json je neplatný, returnType není kompatibilní s JSON nebo nelze číst hodnotu ze čtečky.

ArgumentException

reader používá nepodporované možnosti.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) na poskytnutém context nevrátila kompatibilní JsonTypeInfo pro returnType.

Poznámky

Pokud je vlastnost TokenTypereaderPropertyName nebo None, bude čtenář rozšířen jedním voláním Read() určit začátek hodnoty.

Po dokončení této metody se reader umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka, čtenář se resetuje do stavu, ve který byl při zavolání metody.

Tato metoda vytvoří kopii dat, na která čtenář reagoval, takže neexistuje žádný požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.

JsonReaderOptions sloužící k vytvoření instance Utf8JsonReader mají přednost před JsonSerializerOptions v případě konfliktu. Proto se při čtení používají AllowTrailingCommas, MaxDeptha CommentHandling.

Platí pro

Deserialize(JsonNode, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Převede JsonNode představující jednu hodnotu JSON na 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

Parametry

node: JsonNode

JsonNode, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

-nebo-

context je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Platí pro

Deserialize(JsonNode, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Převede JsonNode představující jednu hodnotu JSON na 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

Parametry

node: JsonNode

JsonNode, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

JsonException

returnType není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Platí pro

Deserialize(JsonElement, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Převede JsonElement představující jednu hodnotu JSON na 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

Parametry

element: JsonElement

JsonElement, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

-nebo-

context je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Platí pro

Deserialize(JsonElement, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Převede JsonElement představující jednu hodnotu JSON na 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

Parametry

element: JsonElement

JsonElement, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

JsonException

returnType není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Platí pro

Deserialize(JsonDocument, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Převede JsonDocument představující jednu hodnotu JSON na 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

Parametry

document: JsonDocument

JsonDocument, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

document je null.

-nebo-

returnType je null.

-nebo-

context je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Platí pro

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Převede JsonDocument představující jednu hodnotu JSON na 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

Parametry

document: JsonDocument

JsonDocument, který chcete převést.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

document nebo returnType je null.

JsonException

returnType není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Platí pro

Deserialize(String, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do returnType.

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

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

Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

Parametry

json: String

Text JSON, který se má analyzovat

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

json nebo returnType je null.

-nebo-

context je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize(String, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do instance zadaného typu.

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

Parametry

json: String

Text JSON, který se má analyzovat.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

json nebo returnType je null.

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

Parametry

json: ReadOnlySpan<Char>

Text JSON, který se má analyzovat

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

json nebo returnType je null.

-nebo-

context je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) poskytnutého context vrátí null pro typ, který se má převést.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do instance zadaného typu.

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

Parametry

json: ReadOnlySpan<Char>

Text JSON, který se má analyzovat.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

Zbývající data jsou v rozsahu nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

Použití rozsahu UTF-16 není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky a převede ji na instanci zadaného typu.

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

Parametry

reader: Utf8JsonReader

Čtenář čte json ze souboru JSON.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování serializátoru během čtení

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

Hodnotu nelze přečíst ze čtečky.

ArgumentException

reader používá nepodporované možnosti.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

Pokud je vlastnost TokenTypereaderJsonTokenType.PropertyName nebo JsonTokenType.None, bude čtenář rozšířen jedním voláním Utf8JsonReader.Read() určit začátek hodnoty.

Po dokončení této metody se reader umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka, čtenář se resetuje do stavu, ve který byl při zavolání metody.

Tato metoda vytvoří kopii dat, na která čtenář reagoval, takže neexistuje žádný požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.

JsonReaderOptions sloužící k vytvoření instance Utf8JsonReader mají přednost před JsonSerializerOptions v případě konfliktu. Proto se při čtení používají JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDeptha JsonReaderOptions.CommentHandling.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do instance zadaného typu.

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

Parametry

utf8Json: ReadOnlySpan<Byte>

Text JSON, který se má analyzovat.

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

JsonException

Json je neplatný.

-nebo-

returnType není kompatibilní s json.

-nebo-

Zbývající data jsou v rozsahu nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

Deserialize(Stream, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do returnType. Stream se přečte do dokončení.

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

Parametry

utf8Json: Stream

Data JSON, která se mají analyzovat

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

utf8Json, returnTypenebo context je null.

JsonException

JSON je neplatný, returnType není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) na poskytnutém context nevrátila kompatibilní JsonTypeInfo pro returnType.

Platí pro

Deserialize(Stream, Type, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do returnType. Stream se přečte do dokončení.

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

Parametry

utf8Json: Stream

Data JSON, která se mají analyzovat

returnType: Type

Typ objektu, na který se má převést a vrátit.

options: JsonSerializerOptions

Možnosti řízení chování při čtení

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

utf8Json nebo returnType je null.

JsonException

JSON je neplatný, returnType není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Platí pro

Deserialize(Utf8JsonReader, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do instance určené jsonTypeInfo.

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

Parametry

reader: Utf8JsonReader

Čtenář, který se má přečíst.

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

JsonException

Json je neplatný, jsonTypeInfo není kompatibilní s JSON nebo nelze číst hodnotu ze čtečky.

ArgumentException

reader používá nepodporované možnosti.

Poznámky

Pokud je vlastnost TokenTypereaderPropertyName nebo None, bude čtenář rozšířen jedním voláním Read() určit začátek hodnoty.

Po dokončení této metody se reader umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka, čtenář se resetuje do stavu, ve který byl při zavolání metody.

Tato metoda vytvoří kopii dat, na která čtenář reagoval, takže neexistuje žádný požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.

Platí pro

Deserialize(JsonNode, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Převede JsonNode představující jednu hodnotu JSON na instanci určenou jsonTypeInfo.

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

Parametry

node: JsonNode

JsonNode, který chcete převést.

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

Platí pro

Deserialize(JsonElement, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Převede JsonElement představující jednu hodnotu JSON na instanci určenou jsonTypeInfo.

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

Parametry

element: JsonElement

JsonElement, který chcete převést.

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

Platí pro

Deserialize(JsonDocument, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Převede JsonDocument představující jednu hodnotu JSON na instanci určenou jsonTypeInfo.

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

Parametry

document: JsonDocument

JsonDocument, který chcete převést.

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

document je null.

-nebo-

jsonTypeInfo je null.

Platí pro

Deserialize(String, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do instance určené jsonTypeInfo.

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

Parametry

json: String

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

json je null.

-nebo-

jsonTypeInfo je null.

JsonException

Json je neplatný.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do instance určené jsonTypeInfo.

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

Parametry

json: ReadOnlySpan<Char>

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

JsonException

Json je neplatný.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do returnType.

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

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

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

Parametry

utf8Json: ReadOnlySpan<Byte>

Text JSON, který se má analyzovat

returnType: Type

Typ objektu, na který se má převést a vrátit.

context: JsonSerializerContext

Zprostředkovatel metadat pro serializovatelné typy.

Návraty

Object

Reprezentace returnType hodnoty JSON.

Výjimky

ArgumentNullException

returnType je null.

JsonException

Json je neplatný, returnType není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

InvalidOperationException

Metoda GetTypeInfo(Type) na poskytnutém context nevrátila kompatibilní JsonTypeInfo pro returnType.

Platí pro

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Parsuje zakódovaný text UTF-8 představující jednu hodnotu JSON do instance určené jsonTypeInfo.

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

Parametry

utf8Json: ReadOnlySpan<Byte>

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo

Metadata o typu, který chcete převést.

Návraty

Object

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

JsonException

JSON je neplatný nebo ve vyrovnávací paměti jsou zbývající data.

Platí pro

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Převede JsonElement představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

element: JsonElement

JsonElement, který chcete převést.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

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

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Zdroj:: JsonSerializer.Read.Element.cs

Převede JsonElement představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

element: JsonElement

JsonElement, který chcete převést.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

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

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Čte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

reader: Utf8JsonReader

Čtenář, který se má přečíst.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

Json je neplatný, TValue není kompatibilní s JSON nebo nelze číst hodnotu ze čtečky.

ArgumentException

reader používá nepodporované možnosti.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Pokud je vlastnost TokenTypereaderPropertyName nebo None, bude čtenář rozšířen jedním voláním Read() určit začátek hodnoty.

Po dokončení této metody se reader umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka, čtenář se resetuje do stavu, ve který byl při zavolání metody.

Tato metoda vytvoří kopii dat, na která čtenář reagoval, takže neexistuje žádný požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.

Platí pro

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

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Převede JsonNode představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

node: JsonNode

JsonNode, který chcete převést.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

jsonTypeInfo je null.

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Zdroj:: JsonSerializer.Read.Utf8JsonReader.cs

Načte jednu hodnotu JSON (včetně objektů nebo polí) ze zadané čtečky do instance typu určeného parametrem obecného typu.

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

Parametry typu

TValue

Cílový typ hodnoty JSON.

Parametry

reader: Utf8JsonReader

Čtenář čte json ze souboru JSON.

options: JsonSerializerOptions

Možnosti řízení chování serializátoru během čtení

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

Hodnotu nelze přečíst ze čtečky.

ArgumentException

reader používá nepodporované možnosti.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Pokud je vlastnost TokenTypereaderJsonTokenType.PropertyName nebo JsonTokenType.None, bude čtenář rozšířen jedním voláním Utf8JsonReader.Read() určit začátek hodnoty.

Po dokončení této metody se reader umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka, čtenář se resetuje do stavu, ve který byl při zavolání metody.

Tato metoda vytvoří kopii dat, na která čtenář reagoval, takže neexistuje žádný požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

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

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Převede JsonDocument představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

document: JsonDocument

JsonDocument, který chcete převést.

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

document je null.

-nebo-

jsonTypeInfo je null.

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Zdroj:: JsonSerializer.Read.Node.cs

Převede JsonNode představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

node: JsonNode

JsonNode, který chcete převést.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Zdroj:: JsonSerializer.Read.Document.cs

Převede JsonDocument představující jednu hodnotu JSON na 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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

document: JsonDocument

JsonDocument, který chcete převést.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

document je null.

JsonException

TValue není kompatibilní s json.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

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

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

json: ReadOnlySpan<Char>

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

json je null.

-nebo-

jsonTypeInfo je null.

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Deserialize<TValue>(String, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Analyzuje text představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.

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

Parametry typu

TValue

Cílový typ hodnoty JSON.

Parametry

json: String

Text JSON, který se má analyzovat.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

json je null.

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

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

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Analyzuje text představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.

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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

json: ReadOnlySpan<Char>

Text JSON, který se má analyzovat.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

Zbývající data jsou v rozsahu nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Použití rozsahu UTF-16 není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

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

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do TValue.

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

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

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

utf8Json: ReadOnlySpan<Byte>

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

Json je neplatný, TValue není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

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

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Zdroj:: JsonSerializer.Read.Span.cs

Parsuje kódovaný text UTF-8 představující jednu hodnotu JSON do instance typu určeného parametrem obecného typu.

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

Parametry typu

TValue

Cílový typ zakódovaného textu UTF-8.

Parametry

utf8Json: ReadOnlySpan<Byte>

Text JSON, který se má analyzovat.

options: JsonSerializerOptions

Možnosti řízení chování při analýze

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

Zbývající data jsou v rozsahu nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Další informace naleznete v tématu Jak serializovat a deserializovat JSON.

Platí pro

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

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do TValue. Stream se přečte do dokončení.

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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

utf8Json: Stream

Data JSON, která se mají analyzovat

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

utf8Json nebo jsonTypeInfo je null.

JsonException

Json je neplatný, TValue není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

Deserialize<TValue>(Stream, JsonSerializerOptions)

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Zdroj:: JsonSerializer.Read.Stream.cs

Přečte kódovaný text UTF-8 představující jednu hodnotu JSON do TValue. Stream se přečte do dokončení.

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

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

utf8Json: Stream

Data JSON, která se mají analyzovat

options: JsonSerializerOptions

Možnosti řízení chování při čtení

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

utf8Json je null.

JsonException

Json je neplatný, TValue není kompatibilní s JSON nebo ve streamu jsou zbývající data.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Platí pro

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

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Zdroj:: JsonSerializer.Read.String.cs

Parsuje text představující jednu hodnotu JSON do TValue.

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

Parametry typu

TValue

Typ pro deserializaci hodnoty JSON do.

Parametry

json: String

Text JSON, který se má analyzovat

jsonTypeInfo: JsonTypeInfo<TValue>

Metadata o typu, který chcete převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

ArgumentNullException

json je null.

-nebo-

jsonTypeInfo je null.

JsonException

Json je neplatný.

-nebo-

TValue není kompatibilní s json.

-nebo-

V řetězci jsou zbývající data nad rámec jedné hodnoty JSON.

NotSupportedException

Není kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

Použití String není tak efektivní jako použití metod UTF-8, protože implementace nativně používá UTF-8.

Platí pro

Sdílet prostřednictvím

JsonSerializer.Deserialize Metoda

Definice

Přetížení

Deserialize(Stream, JsonTypeInfo)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(JsonNode, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(JsonNode, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(JsonElement, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(JsonElement, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(JsonDocument, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Platí pro

Deserialize(String, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(String, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Parametry

Návraty

Výjimky

Poznámky