JsonSerializer.Deserialize Metoda

Definice

Přetížení

Deserialize(Stream, JsonTypeInfo)

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

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Načte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře do objektu returnType.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Přečte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře a převede ji na instanci zadaného typu.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Převede JsonNode hodnotu představující jednu hodnotu JSON na returnType.

Deserialize(JsonElement, Type, JsonSerializerContext)

Převede JsonElement hodnotu představující jednu hodnotu JSON na returnType.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Převede JsonElement hodnotu představující jednu hodnotu JSON na returnType.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Převede JsonDocument hodnotu představující jednu hodnotu JSON na returnType.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Převede JsonDocument hodnotu 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(JsonNode, Type, JsonSerializerContext)

Převede JsonNode hodnotu představující jednu hodnotu JSON na returnType.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

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

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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

Deserialize(String, JsonTypeInfo)

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

Deserialize(JsonDocument, JsonTypeInfo)

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

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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

Deserialize(JsonNode, JsonTypeInfo)

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

Deserialize(Utf8JsonReader, JsonTypeInfo)

Načte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře do instance určené nástrojem jsonTypeInfo.

Deserialize(Stream, Type, JsonSerializerOptions)

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

Deserialize(Stream, Type, JsonSerializerContext)

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

Deserialize(JsonElement, JsonTypeInfo)

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

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

Načte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře do objektu TValue.

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

Převede JsonDocument hodnotu představující jednu hodnotu JSON na TValue.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Přečte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře do instance typu určeného parametrem obecného typu.

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

Převede JsonNode hodnotu představující jednu hodnotu JSON na TValue.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Převede JsonNode hodnotu představující jednu hodnotu JSON na TValue.

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

Převede JsonElement hodnotu představující jednu hodnotu JSON na TValue.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Převede JsonElement hodnotu představující jednu hodnotu JSON na TValue.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Převede JsonDocument hodnotu představující jednu hodnotu JSON na TValue.

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

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

Deserialize<TValue>(String, JsonSerializerOptions)

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

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

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

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

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

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

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

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

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

Deserialize<TValue>(Stream, JsonSerializerOptions)

Načte text kódovaný UTF-8 představující jednu hodnotu JSON do objektu TValue. Stream se přečte až 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

Načte text kódovaný UTF-8 představující jednu hodnotu JSON do instance určené parametrem jsonTypeInfo. Stream se přečte až 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ý se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

utf8Json nebo jsonTypeInfo je null.

Json je neplatný nebo ve streamu zbývají data.

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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í) od zadaného čtenáře returnTypedo .

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

Reprezentace returnType hodnoty JSON.

Výjimky

returnType nebo context je null.

Kód JSON je neplatný, returnType není kompatibilní s kódem JSON nebo se nepodařilo načíst hodnotu od čtenáře.

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

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) v zadaném context souboru nevrátila kompatibilní JsonTypeInfo pro returnType.

Poznámky

TokenType Pokud je PropertyNameNonevlastnost reader nebo , bude čtenář rozšířen o jedno volání k Read() určení začátku hodnoty.

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

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

Objekt JsonReaderOptions použitý k vytvoření instance Utf8JsonReader má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se AllowTrailingCommaspři čtení používají , MaxDeptha CommentHandling .

Platí pro

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Utf8JsonReader.cs
Zdroj:
JsonSerializer.Read.Utf8JsonReader.cs
Zdroj:
JsonSerializer.Read.Utf8JsonReader.cs

Přečte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře 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ář, ze které se má kód JSON číst.

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

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Hodnotu nelze přečíst od čtenáře.

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

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

TokenType Pokud je JsonTokenType.PropertyNameJsonTokenType.Nonevlastnost reader nebo , bude čtenář rozšířen o jedno volání k Utf8JsonReader.Read() určení začátku hodnoty.

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

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

Objekt JsonReaderOptions použitý k vytvoření instance Utf8JsonReader má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se JsonReaderOptions.AllowTrailingCommaspři čtení používají , JsonReaderOptions.MaxDeptha JsonReaderOptions.CommentHandling .

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

Platí pro

Deserialize(JsonNode, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs

JsonNode Převede 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

Hodnota JsonNode , která se má převést.

returnType
Type

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

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

returnType není kompatibilní se souborem JSON.

Neexistuje žádný 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

JsonElement Převede 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

Hodnota JsonElement , která se má 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

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

-nebo-

context je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) zadané contextnull vrátí pro typ k převodu.

Platí pro

Deserialize(JsonElement, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Element.cs
Zdroj:
JsonSerializer.Read.Element.cs
Zdroj:
JsonSerializer.Read.Element.cs

JsonElement Převede 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

Hodnota JsonElement , která se má převést.

returnType
Type

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

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

returnType není kompatibilní se souborem JSON.

Neexistuje žádný 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

JsonDocument Převede 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

Hodnota JsonDocument , která se má 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

Reprezentace returnType hodnoty JSON.

Výjimky

document je null.

-nebo-

returnType je null.

-nebo-

context je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) zadané contextnull vrátí pro typ k převodu.

Platí pro

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs

JsonDocument Převede 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

Hodnota JsonDocument , která se má převést.

returnType
Type

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

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

document nebo returnType je null.

returnType není kompatibilní se souborem JSON.

Neexistuje žádný 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

Reprezentace returnType hodnoty JSON.

Výjimky

json nebo returnType je null.

-nebo-

context je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) zadané contextnull vrátí pro typ k převodu.

Poznámky

String Použití 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í během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

json nebo returnType je null.

Json je neplatný.

-nebo-

TValue není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

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

Další informace najdete 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

Reprezentace returnType hodnoty JSON.

Výjimky

json nebo returnType je null.

-nebo-

context je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) zadané contextnull vrátí pro typ k převodu.

Poznámky

String Použití 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í během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

V rozsahu nad rámec jedné hodnoty JSON zbývají data.

Neexistuje žádný 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(JsonNode, Type, JsonSerializerContext)

Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs

JsonNode Převede 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

Hodnota JsonNode , která se má 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

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

-nebo-

context je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) zadané contextnull vrátí pro typ k převodu.

Platí pro

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs

Parsuje text kódovaný 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í během analýzy

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

Json je neplatný.

-nebo-

returnType není kompatibilní se souborem JSON.

-nebo-

V rozsahu nad rámec jedné hodnoty JSON zbývají data.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Poznámky

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

Platí pro

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs

Parsuje text kódovaný 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

Reprezentace returnType hodnoty JSON.

Výjimky

returnType je null.

Kód JSON je neplatný, returnType není kompatibilní s kódem JSON nebo stream obsahuje zbývající data.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) v zadaném context souboru nevrátila kompatibilní JsonTypeInfo pro returnType.

Platí pro

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs

Parsuje text kódovaný UTF-8 představující jednu hodnotu JSON do instance určené parametrem 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ý se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

Kód JSON je neplatný nebo ve vyrovnávací paměti zůstávají data.

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é parametrem 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ý se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

json je null.

-nebo-

jsonTypeInfo je null.

Json je neplatný.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Poznámky

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

Platí pro

Deserialize(JsonDocument, JsonTypeInfo)

Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs

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

Hodnota JsonDocument , která se má převést.

jsonTypeInfo
JsonTypeInfo

Metadata o typu, který se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

document je null.

-nebo-

jsonTypeInfo je null.

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é parametrem 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ý se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

jsonTypeInfo je null.

Json je neplatný.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Poznámky

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

Platí pro

Deserialize(JsonNode, JsonTypeInfo)

Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs

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

Hodnota JsonNode , která se má převést.

jsonTypeInfo
JsonTypeInfo

Metadata o typu, který se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

jsonTypeInfo je null.

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í) od zadaného čtenáře do instance určené parametrem 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ý se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

Kód JSON je neplatný, jsonTypeInfo není kompatibilní s kódem JSON nebo se nepodařilo načíst hodnotu od čtenáře.

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

Poznámky

TokenType Pokud je PropertyNameNonevlastnost reader nebo , bude čtenář rozšířen o jedno volání k Read() určení začátku hodnoty.

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

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

Objekt JsonReaderOptions použitý k vytvoření instance Utf8JsonReader má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se AllowTrailingCommaspři čtení používají , MaxDeptha CommentHandling .

Platí pro

Deserialize(Stream, Type, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Stream.cs
Zdroj:
JsonSerializer.Read.Stream.cs
Zdroj:
JsonSerializer.Read.Stream.cs

Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do returnType. Stream se přečte až 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 pro řízení chování při čtení.

Návraty

Reprezentace returnType hodnoty JSON.

Výjimky

utf8Json nebo returnType je null.

Kód JSON je neplatný, returnType není kompatibilní s kódem JSON nebo ve streamu zůstávají data.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Platí pro

Deserialize(Stream, Type, JsonSerializerContext)

Zdroj:
JsonSerializer.Read.Stream.cs
Zdroj:
JsonSerializer.Read.Stream.cs
Zdroj:
JsonSerializer.Read.Stream.cs

Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do returnType. Stream se přečte až 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

Reprezentace returnType hodnoty JSON.

Výjimky

utf8Json, returnTypenebo context je null.

Kód JSON je neplatný, returnType není kompatibilní s kódem JSON nebo ve streamu zůstávají data.

Neexistuje žádný kompatibilní JsonConverter pro returnType nebo jeho serializovatelné členy.

Metoda GetTypeInfo(Type) v zadaném context souboru nevrátila kompatibilní JsonTypeInfo pro returnType.

Platí pro

Deserialize(JsonElement, JsonTypeInfo)

Zdroj:
JsonSerializer.Read.Element.cs
Zdroj:
JsonSerializer.Read.Element.cs

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

Hodnota JsonElement , která se má převést.

jsonTypeInfo
JsonTypeInfo

Metadata o typu, který se má převést.

Návraty

Reprezentace jsonTypeInfo hodnoty JSON.

Výjimky

jsonTypeInfo je null.

Platí pro

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

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í) od zadaného čtenáře TValuedo .

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, do který se má deserializovat hodnota JSON.

Parametry

reader
Utf8JsonReader

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

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

Kód JSON je neplatný, TValue není kompatibilní s kódem JSON nebo se nepodařilo načíst hodnotu od čtenáře.

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

Neexistuje žádný kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

TokenType Pokud je PropertyNameNonevlastnost reader nebo , bude čtenář rozšířen o jedno volání k Read() určení začátku hodnoty.

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

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

Objekt JsonReaderOptions použitý k vytvoření instance Utf8JsonReader má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se AllowTrailingCommaspři čtení používají , MaxDeptha CommentHandling .

Platí pro

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

Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs

JsonDocument Převede 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, do který se má deserializovat hodnota JSON.

Parametry

document
JsonDocument

Hodnota JsonDocument , která se má převést.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

document je null.

-nebo-

jsonTypeInfo je null.

TValue není kompatibilní se souborem JSON.

Neexistuje žádný 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

Přečte jednu hodnotu JSON (včetně objektů nebo polí) z poskytnutého čtenáře 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ář, ze které se má kód JSON číst.

options
JsonSerializerOptions

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

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

Json je neplatný.

-nebo-

TValue není kompatibilní se souborem JSON.

-nebo-

Hodnotu nelze přečíst od čtenáře.

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

Neexistuje žádný kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

TokenType Pokud je JsonTokenType.PropertyNameJsonTokenType.Nonevlastnost reader nebo , bude čtenář rozšířen o jedno volání k Utf8JsonReader.Read() určení začátku hodnoty.

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

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

Objekt JsonReaderOptions použitý k vytvoření instance Utf8JsonReader má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se JsonReaderOptions.AllowTrailingCommaspři čtení používají , JsonReaderOptions.MaxDeptha JsonReaderOptions.CommentHandling .

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

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 hodnotu 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, do který se má deserializovat hodnota JSON.

Parametry

node
JsonNode

Příkaz JsonNode k převodu.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

jsonTypeInfo je null.

TValue není kompatibilní s kódem JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Platí pro

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs
Zdroj:
JsonSerializer.Read.Node.cs

Převede JsonNode hodnotu 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, do který se má deserializovat hodnota JSON.

Parametry

node
JsonNode

Příkaz JsonNode k převodu.

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

TValue není kompatibilní s kódem JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

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 hodnotu 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, do který se má deserializovat hodnota JSON.

Parametry

element
JsonElement

Příkaz JsonElement k převodu.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

jsonTypeInfo je null.

TValue není kompatibilní s kódem JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Platí pro

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Element.cs
Zdroj:
JsonSerializer.Read.Element.cs
Zdroj:
JsonSerializer.Read.Element.cs

Převede JsonElement hodnotu 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, do který se má deserializovat hodnota JSON.

Parametry

element
JsonElement

Příkaz JsonElement k převodu.

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

TValue není kompatibilní s kódem JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Platí pro

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs
Zdroj:
JsonSerializer.Read.Document.cs

Převede JsonDocument hodnotu 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, do který se má deserializovat hodnota JSON.

Parametry

document
JsonDocument

Příkaz JsonDocument k převodu.

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

document je null.

TValue není kompatibilní s kódem JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Platí pro

Deserialize<TValue>(ReadOnlySpan<Char>, 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 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, do který se má deserializovat hodnota JSON.

Parametry

json
ReadOnlySpan<Char>

Text JSON, který se má analyzovat.

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

Kód JSON je neplatný.

-nebo-

TValue není kompatibilní s kódem JSON.

-nebo-

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

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

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>(String, 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 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í během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

json je null.

Kód JSON je neplatný.

-nebo-

TValue není kompatibilní s kódem JSON.

-nebo-

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

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Poznámky

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

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

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, do který se má deserializovat hodnota JSON.

Parametry

json
ReadOnlySpan<Char>

Text JSON, který se má analyzovat.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

json je null.

-nebo-

jsonTypeInfo je null.

Kód JSON je neplatný.

-nebo-

TValue není kompatibilní s kódem JSON.

-nebo-

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

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Poznámky

String Použití 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 text kódovaný 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, do který se má deserializovat hodnota JSON.

Parametry

utf8Json
ReadOnlySpan<Byte>

Text JSON, který se má analyzovat.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

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

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Platí pro

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

Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs
Zdroj:
JsonSerializer.Read.Span.cs

Parsuje text kódovaný 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 textu kódování UTF-8.

Parametry

utf8Json
ReadOnlySpan<Byte>

Text JSON, který se má analyzovat.

options
JsonSerializerOptions

Možnosti řízení chování během analýzy

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

Kód JSON je neplatný.

-nebo-

TValue není kompatibilní s kódem JSON.

-nebo-

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

Neexistuje žádný kompatibilní JsonConverter pro TValue serializovatelné členy nebo.

Poznámky

Další informace najdete 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

Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do TValue. Stream se přečte až 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, do který se má deserializovat hodnota JSON.

Parametry

utf8Json
Stream

Data JSON, která se mají analyzovat.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

utf8Json nebo jsonTypeInfo je null.

Kód JSON je neplatný, TValue není kompatibilní s kódem JSON nebo stream obsahuje zbývající data.

Neexistuje žádný 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

Načte text kódovaný UTF-8, který představuje jednu hodnotu JSON do TValue. Stream se přečte až 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, do který se má deserializovat hodnota JSON.

Parametry

utf8Json
Stream

Data JSON, která se mají analyzovat.

options
JsonSerializerOptions

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

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

utf8Json je null.

Kód JSON je neplatný, TValue není kompatibilní s kódem JSON nebo stream obsahuje zbývající data.

Neexistuje žádný 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, do který se má deserializovat hodnota JSON.

Parametry

json
String

Text JSON, který se má analyzovat.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata o typu, který se má převést.

Návraty

TValue

Reprezentace TValue hodnoty JSON.

Výjimky

json je null.

-nebo-

jsonTypeInfo je null.

Json je neplatný.

-nebo-

TValue není kompatibilní se souborem JSON.

-nebo-

Řetězec obsahuje zbývající data nad rámec jedné hodnoty JSON.

Neexistuje žádný kompatibilní JsonConverter pro TValue nebo jeho serializovatelné členy.

Poznámky

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

Platí pro