JsonSerializer.Deserialize Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

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

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.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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.

Deserialize(JsonNode, Type, JsonSerializerContext)

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.

Deserialize(JsonNode, Type, JsonSerializerOptions)

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.

Deserialize(JsonElement, Type, JsonSerializerContext)

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.

Deserialize(JsonElement, Type, JsonSerializerOptions)

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.

Deserialize(JsonDocument, Type, JsonSerializerContext)

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.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

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.

Deserialize(String, Type, JsonSerializerContext)

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.

Deserialize(String, Type, JsonSerializerOptions)

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

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

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

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.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

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

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

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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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

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

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.

Deserialize(Stream, Type, JsonSerializerContext)

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.

Deserialize(Stream, Type, JsonSerializerOptions)

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.

Deserialize(Utf8JsonReader, JsonTypeInfo)

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.

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.

Deserialize(JsonNode, JsonTypeInfo)

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.

Deserialize(JsonElement, JsonTypeInfo)

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.

Deserialize(JsonDocument, JsonTypeInfo)

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.

Deserialize(String, JsonTypeInfo)

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.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

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.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

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.

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

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.

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

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.

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.

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

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.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

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

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

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.

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.

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

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.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

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.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

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.

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

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.

Deserialize<TValue>(String, JsonSerializerOptions)

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

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

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.

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

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.

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

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.

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

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

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

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.

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

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.

Deserialize<TValue>(Stream, JsonSerializerOptions)

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.

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

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.