JsonSerializer.Deserialize Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Przeciążenia

Deserialize(Stream, JsonTypeInfo)	Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo. Strumień zostanie odczytany do ukończenia.
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do returnType.
Deserialize(JsonNode, Type, JsonSerializerContext)	Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(JsonNode, Type, JsonSerializerOptions)	Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(JsonElement, Type, JsonSerializerContext)	Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(JsonElement, Type, JsonSerializerOptions)	Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(JsonDocument, Type, JsonSerializerContext)	Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na returnType.
Deserialize(String, Type, JsonSerializerContext)	Analizuje tekst reprezentujący pojedynczą wartość JSON w returnType.
Deserialize(String, Type, JsonSerializerOptions)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	Analizuje tekst reprezentujący pojedynczą wartość JSON w returnType.
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu.
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika i konwertuje ją na wystąpienie określonego typu.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu.
Deserialize(Stream, Type, JsonSerializerContext)	Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType. Strumień zostanie odczytany do ukończenia.
Deserialize(Stream, Type, JsonSerializerOptions)	Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType. Strumień zostanie odczytany do ukończenia.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do wystąpienia określonego przez jsonTypeInfo.
Deserialize(JsonNode, JsonTypeInfo)	Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na wystąpienie określone przez jsonTypeInfo.
Deserialize(JsonElement, JsonTypeInfo)	Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na wystąpienie określone przez jsonTypeInfo.
Deserialize(JsonDocument, JsonTypeInfo)	Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na wystąpienie określone przez jsonTypeInfo.
Deserialize(String, JsonTypeInfo)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType.
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do TValue.
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do wystąpienia typu określonego przez parametr typu ogólnego.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na TValue.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	Analizuje tekst reprezentujący pojedynczą wartość JSON w TValue.
Deserialize<TValue>(String, JsonSerializerOptions)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr typu.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr typu.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue.
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego.
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue. Strumień zostanie odczytany do ukończenia.
Deserialize<TValue>(Stream, JsonSerializerOptions)	Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue. Strumień zostanie odczytany do ukończenia.
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	Analizuje tekst reprezentujący pojedynczą wartość JSON w TValue.

Deserialize(Stream, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Stream.cs

Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez jsonTypeInfo. Strumień zostanie odczytany do ukończenia.

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

Dane JSON do analizy.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

utf8Json lub jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy lub istnieją pozostałe dane w usłudze Stream.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Utf8JsonReader.cs

Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika 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

Czytelnik do czytania.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType lub context jest null.

JsonException

Kod JSON jest nieprawidłowy, returnType nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.

ArgumentException

reader używa nieobsługiwanych opcji.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) w podanym context nie zwróciła zgodnego JsonTypeInfo dla returnType.

Uwagi

Jeśli właściwość TokenTypereader jest PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.

Po zakończeniu tej metody reader jest umieszczony na ostatnim tokenie w wartości JSON. Jeśli zgłaszany jest wyjątek, czytnik jest resetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymagania wywołującego, aby zachować integralność danych poza zwróceniem tej metody.

JsonReaderOptions użyte do utworzenia wystąpienia Utf8JsonReader mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym AllowTrailingCommas, MaxDepthi CommentHandling są używane podczas odczytywania.

Deserialize(JsonNode, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Node.cs

Konwertuje JsonNode reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

-lub-

context jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) podanej context zwraca null dla typu do konwersji.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Node.cs

Konwertuje JsonNode reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

JsonException

returnType nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Deserialize(JsonElement, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Element.cs

Konwertuje JsonElement reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

-lub-

context jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) podanej context zwraca null dla typu do konwersji.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Element.cs

Konwertuje JsonElement reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

JsonException

returnType nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Document.cs

Konwertuje JsonDocument reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

document jest null.

-lub-

returnType jest null.

-lub-

context jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) podanej context zwraca null dla typu do konwersji.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Document.cs

Konwertuje JsonDocument reprezentującą pojedynczą wartość 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 do konwersji.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

document lub returnType jest null.

JsonException

returnType nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Deserialize(String, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w 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

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json lub returnType jest null.

-lub-

context jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) podanej context zwraca null dla typu do konwersji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize(String, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego 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

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json lub returnType jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w 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>

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json lub returnType jest null.

-lub-

context jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) podanej context zwraca null dla typu do konwersji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego 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>

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Uwagi

Użycie zakresu UTF-16 nie jest tak wydajne, jak użycie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Utf8JsonReader.cs

Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika i konwertuje ją na wystąpienie określonego 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

Czytelnik odczytu z pliku JSON.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania serializatora podczas odczytywania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

Nie można odczytać wartości z czytnika.

ArgumentException

reader używa nieobsługiwanych opcji.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Uwagi

Jeśli właściwość TokenTypereader jest JsonTokenType.PropertyName lub JsonTokenType.None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Utf8JsonReader.Read() określić początek wartości.

Po zakończeniu tej metody reader zostaną umieszczone na ostatnim tokenie w wartości JSON. Jeśli zgłaszany jest wyjątek, czytnik jest resetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymagania wywołującego, aby zachować integralność danych poza zwróceniem tej metody.

JsonReaderOptions użyte do utworzenia wystąpienia Utf8JsonReader mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthi JsonReaderOptions.CommentHandling są używane podczas odczytywania.

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Span.cs

Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonego 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>

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

returnType nie jest zgodny z plikiem JSON.

-lub-

Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Uwagi

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

Deserialize(Stream, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Stream.cs

Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType. Strumień zostanie odczytany do ukończenia.

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

Dane JSON do analizy.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

utf8Json, returnTypelub context jest null.

JsonException

Kod JSON jest nieprawidłowy, returnType nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) w podanym context nie zwróciła zgodnego JsonTypeInfo dla returnType.

Deserialize(Stream, Type, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Stream.cs

Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w returnType. Strumień zostanie odczytany do ukończenia.

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

Dane JSON do analizy.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas odczytywania.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

utf8Json lub returnType jest null.

JsonException

Kod JSON jest nieprawidłowy, returnType nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

Deserialize(Utf8JsonReader, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Utf8JsonReader.cs

Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do wystąpienia określonego przez 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

Czytelnik do czytania.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy, jsonTypeInfo nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.

ArgumentException

reader używa nieobsługiwanych opcji.

Uwagi

Jeśli właściwość TokenTypereader jest PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.

Po zakończeniu tej metody reader zostaną umieszczone na ostatnim tokenie w wartości JSON. Jeśli zgłaszany jest wyjątek, czytnik jest resetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymagania wywołującego, aby zachować integralność danych poza zwróceniem tej metody.

JsonReaderOptions użyte do utworzenia wystąpienia Utf8JsonReader mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym AllowTrailingCommas, MaxDepthi CommentHandling są używane podczas odczytywania.

Deserialize(JsonNode, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Node.cs

Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na wystąpienie określone przez 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 do konwersji.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

jsonTypeInfo jest null.

Deserialize(JsonElement, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Element.cs

Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na wystąpienie określone przez 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 do konwersji.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

jsonTypeInfo jest null.

Deserialize(JsonDocument, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Document.cs

Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na wystąpienie określone przez 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 do konwersji.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

document jest null.

-lub-

jsonTypeInfo jest null.

Deserialize(String, JsonTypeInfo)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez 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

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json jest null.

-lub-

jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez 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>

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Źródło:

JsonSerializer.Read.Span.cs

Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w 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>

Tekst JSON do przeanalizowana.

returnType

Type

Typ obiektu, który ma być konwertowany na i zwracany.

context

JsonSerializerContext

Dostawca metadanych dla typów możliwych do serializacji.

Zwraca

Object

returnType reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

returnType jest null.

JsonException

Kod JSON jest nieprawidłowy, returnType nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla returnType ani jego składowych z możliwością serializacji.

InvalidOperationException

Metoda GetTypeInfo(Type) w podanym context nie zwróciła zgodnego JsonTypeInfo dla returnType.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Źródło:

JsonSerializer.Read.Span.cs

Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez 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>

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo

Metadane dotyczące typu do konwersji.

Zwraca

Object

jsonTypeInfo reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy lub istnieją pozostałe dane w buforze.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Element.cs

Konwertuje JsonElement reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

element

JsonElement

JsonElement do konwersji.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

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

Źródło:

JsonSerializer.Read.Element.cs

Konwertuje JsonElement reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

element

JsonElement

JsonElement do konwersji.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

jsonTypeInfo jest null.

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

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

Źródło:

JsonSerializer.Read.Utf8JsonReader.cs

Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika 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 do deserializacji wartości JSON.

Parametry

reader

Utf8JsonReader

Czytelnik do czytania.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy, TValue nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.

ArgumentException

reader używa nieobsługiwanych opcji.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Jeśli właściwość TokenTypereader jest PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.

Po zakończeniu tej metody reader jest umieszczony na ostatnim tokenie w wartości JSON. Jeśli zgłaszany jest wyjątek, czytnik jest resetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymagania wywołującego, aby zachować integralność danych poza zwróceniem tej metody.

JsonReaderOptions użyte do utworzenia wystąpienia Utf8JsonReader mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym AllowTrailingCommas, MaxDepthi CommentHandling są używane podczas odczytywania.

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

Źródło:

JsonSerializer.Read.Node.cs

Konwertuje JsonNode reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

node

JsonNode

JsonNode do konwersji.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

jsonTypeInfo jest null.

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Utf8JsonReader.cs

Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do wystąpienia typu określonego przez parametr typu ogólnego.

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

Typ docelowy wartości JSON.

Parametry

reader

Utf8JsonReader

Czytelnik odczytu z pliku JSON.

options

JsonSerializerOptions

Opcje kontrolowania zachowania serializatora podczas odczytywania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

Nie można odczytać wartości z czytnika.

ArgumentException

reader używa nieobsługiwanych opcji.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Jeśli właściwość TokenTypereader jest JsonTokenType.PropertyName lub JsonTokenType.None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Utf8JsonReader.Read() określić początek wartości.

Po zakończeniu tej metody reader zostaną umieszczone na ostatnim tokenie w wartości JSON. Jeśli zgłaszany jest wyjątek, czytnik jest resetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymagania wywołującego, aby zachować integralność danych poza zwróceniem tej metody.

JsonReaderOptions użyte do utworzenia wystąpienia Utf8JsonReader mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepthi JsonReaderOptions.CommentHandling są używane podczas odczytywania.

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

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

Źródło:

JsonSerializer.Read.Document.cs

Konwertuje JsonDocument reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

document

JsonDocument

JsonDocument do konwersji.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

document jest null.

-lub-

jsonTypeInfo jest null.

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Node.cs

Konwertuje JsonNode reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

node

JsonNode

JsonNode do konwersji.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Document.cs

Konwertuje JsonDocument reprezentującą pojedynczą wartość 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 deserializacji wartości JSON.

Parametry

document

JsonDocument

JsonDocument do konwersji.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

document jest null.

JsonException

TValue nie jest zgodny z plikiem JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

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

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w 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 deserializacji wartości JSON.

Parametry

json

ReadOnlySpan<Char>

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json jest null.

-lub-

jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Deserialize<TValue>(String, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr 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

Typ docelowy wartości JSON.

Parametry

json

String

Tekst JSON do przeanalizowana.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

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

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr 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 deserializacji wartości JSON.

Parametry

json

ReadOnlySpan<Char>

Tekst JSON do przeanalizowana.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Użycie zakresu UTF-16 nie jest tak wydajne, jak użycie metod UTF-8, ponieważ implementacja natywnie używa utF-8.

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

Źródło:

JsonSerializer.Read.Span.cs

Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w 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 deserializacji wartości JSON.

Parametry

utf8Json

ReadOnlySpan<Byte>

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy, TValue nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

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

Źródło:

JsonSerializer.Read.Span.cs

Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego.

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

Typ docelowy zakodowanego tekstu UTF-8.

Parametry

utf8Json

ReadOnlySpan<Byte>

Tekst JSON do przeanalizowana.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas analizowania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.

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

Źródło:

JsonSerializer.Read.Stream.cs

Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue. Strumień zostanie odczytany do ukończenia.

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 deserializacji wartości JSON.

Parametry

utf8Json

Stream

Dane JSON do analizy.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

utf8Json lub jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy, TValue nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Źródło:

JsonSerializer.Read.Stream.cs

Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w TValue. Strumień zostanie odczytany do ukończenia.

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 deserializacji wartości JSON.

Parametry

utf8Json

Stream

Dane JSON do analizy.

options

JsonSerializerOptions

Opcje kontrolowania zachowania podczas odczytywania.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

utf8Json jest null.

JsonException

Kod JSON jest nieprawidłowy, TValue nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

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

Źródło:

JsonSerializer.Read.String.cs

Analizuje tekst reprezentujący pojedynczą wartość JSON w 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 deserializacji wartości JSON.

Parametry

json

String

Tekst JSON do przeanalizowana.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadane dotyczące typu do konwersji.

Zwraca

TValue

TValue reprezentacja wartości JSON.

Wyjątki

ArgumentNullException

json jest null.

-lub-

jsonTypeInfo jest null.

JsonException

Kod JSON jest nieprawidłowy.

-lub-

TValue nie jest zgodny z plikiem JSON.

-lub-

W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.

NotSupportedException

Nie ma zgodnych JsonConverter dla TValue ani jego składowych z możliwością serializacji.

Uwagi

Użycie String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.