JsonSerializer.Deserialize Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
Deserialize(Stream, JsonTypeInfo) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize(JsonNode, Type, JsonSerializerOptions) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize(JsonElement, Type, JsonSerializerContext) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize(JsonElement, Type, JsonSerializerOptions) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize(JsonDocument, Type, JsonSerializerContext) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na |
Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na |
Deserialize(String, Type, JsonSerializerContext) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w |
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 |
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 |
Deserialize(Stream, Type, JsonSerializerOptions) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do wystąpienia określonego przez |
Deserialize(JsonNode, JsonTypeInfo) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize(JsonElement, JsonTypeInfo) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize(JsonDocument, JsonTypeInfo) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize(String, JsonTypeInfo) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Analizuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w wystąpieniu określonym przez |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
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 |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w |
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 |
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 |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Odczytuje zakodowany tekst UTF-8 reprezentujący pojedynczą wartość JSON w |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w |
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.
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
jest null
.
Kod JSON jest nieprawidłowy lub istnieją pozostałe dane w usłudze Stream.
Dotyczy
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
lub context
jest null
.
Kod JSON jest nieprawidłowy, returnType
nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
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.
Dotyczy
Deserialize(JsonNode, Type, JsonSerializerContext)
- Źródło:
- JsonSerializer.Read.Node.cs
- Źródło:
- JsonSerializer.Read.Node.cs
- Ź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
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów możliwych do serializacji.
Zwraca
returnType
reprezentacja wartości JSON.
Wyjątki
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.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) podanej context
zwraca null
dla typu do konwersji.
Dotyczy
Deserialize(JsonNode, Type, JsonSerializerOptions)
- Źródło:
- JsonSerializer.Read.Node.cs
- Źródło:
- JsonSerializer.Read.Node.cs
- Ź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
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize(JsonElement, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
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.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) podanej context
zwraca null
dla typu do konwersji.
Dotyczy
Deserialize(JsonElement, Type, JsonSerializerOptions)
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
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
jest null
.
returnType
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize(JsonDocument, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
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.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) podanej context
zwraca null
dla typu do konwersji.
Dotyczy
Deserialize(JsonDocument, Type, JsonSerializerOptions)
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
returnType
reprezentacja wartości JSON.
Wyjątki
document
lub returnType
jest null
.
returnType
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize(String, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
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.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
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.
Dotyczy
Deserialize(String, Type, JsonSerializerOptions)
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);
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
Tekst JSON do przeanalizowana.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
returnType
reprezentacja wartości JSON.
Wyjątki
json
lub returnType
jest null
.
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.
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.
Dotyczy
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
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.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
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.
Dotyczy
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
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
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
jest null
.
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.
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.
Dotyczy
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.
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
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
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
jest null
.
Kod JSON jest nieprawidłowy.
-lub-
returnType
nie jest zgodny z plikiem JSON.
-lub-
Nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
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.
Dotyczy
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)
- Źródło:
- JsonSerializer.Read.Span.cs
- Źródło:
- JsonSerializer.Read.Span.cs
- Ź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);
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>
Tekst JSON do przeanalizowana.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
jest null
.
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.
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.
Dotyczy
Deserialize(Stream, Type, JsonSerializerContext)
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
returnType
reprezentacja wartości JSON.
Wyjątki
utf8Json
, returnType
lub context
jest null
.
Kod JSON jest nieprawidłowy, returnType
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) w podanym context
nie zwróciła zgodnego JsonTypeInfo dla returnType
.
Dotyczy
Deserialize(Stream, Type, JsonSerializerOptions)
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
returnType
reprezentacja wartości JSON.
Wyjątki
utf8Json
lub returnType
jest null
.
Kod JSON jest nieprawidłowy, returnType
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize(Utf8JsonReader, JsonTypeInfo)
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy, jsonTypeInfo
nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.
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.
Dotyczy
Deserialize(JsonNode, JsonTypeInfo)
- Źródło:
- JsonSerializer.Read.Node.cs
- Ź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
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
jsonTypeInfo
jest null
.
Dotyczy
Deserialize(JsonElement, JsonTypeInfo)
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
jsonTypeInfo
jest null
.
Dotyczy
Deserialize(JsonDocument, JsonTypeInfo)
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
Dotyczy
Deserialize(String, JsonTypeInfo)
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
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.
Dotyczy
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
jsonTypeInfo
jest null
.
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.
Dotyczy
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)
- Źródło:
- JsonSerializer.Read.Span.cs
- Źródło:
- JsonSerializer.Read.Span.cs
- Ź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
returnType
reprezentacja wartości JSON.
Wyjątki
returnType
jest null
.
Kod JSON jest nieprawidłowy, returnType
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla returnType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) w podanym context
nie zwróciła zgodnego JsonTypeInfo dla returnType
.
Dotyczy
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
- Źródło:
- JsonSerializer.Read.Span.cs
- Ź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
jsonTypeInfo
reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy lub istnieją pozostałe dane w buforze.
Dotyczy
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
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
reprezentacja wartości JSON.
Wyjątki
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
jsonTypeInfo
jest null
.
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
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.
Dotyczy
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)
- Źródło:
- JsonSerializer.Read.Node.cs
- Źródło:
- JsonSerializer.Read.Node.cs
- Ź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
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
TValue
reprezentacja wartości JSON.
Wyjątki
jsonTypeInfo
jest null
.
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
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.
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
Typ docelowy wartości JSON.
Parametry
- reader
- Utf8JsonReader
Czytelnik odczytu z pliku JSON.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializatora podczas odczytywania.
Zwraca
TValue
reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
nie jest zgodny z plikiem JSON.
-lub-
Nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
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.
Dotyczy
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
- Źródło:
- JsonSerializer.Read.Node.cs
- Źródło:
- JsonSerializer.Read.Node.cs
- Ź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
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
TValue
reprezentacja wartości JSON.
Wyjątki
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
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
reprezentacja wartości JSON.
Wyjątki
document
jest null
.
TValue
nie jest zgodny z plikiem JSON.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
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.
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.
Dotyczy
Deserialize<TValue>(String, JsonSerializerOptions)
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);
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
Typ docelowy wartości JSON.
Parametry
- json
- String
Tekst JSON do przeanalizowana.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
TValue
reprezentacja wartości JSON.
Wyjątki
json
jest null
.
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.
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.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
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
reprezentacja wartości JSON.
Wyjątki
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.
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.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)
- Źródło:
- JsonSerializer.Read.Span.cs
- Źródło:
- JsonSerializer.Read.Span.cs
- Ź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
reprezentacja wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
- Źródło:
- JsonSerializer.Read.Span.cs
- Źródło:
- JsonSerializer.Read.Span.cs
- Ź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);
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
Typ docelowy zakodowanego tekstu UTF-8.
Parametry
- utf8Json
- ReadOnlySpan<Byte>
Tekst JSON do przeanalizowana.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
TValue
reprezentacja wartości JSON.
Wyjątki
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.
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.
Dotyczy
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
jest null
.
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(Stream, JsonSerializerOptions)
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
reprezentacja wartości JSON.
Wyjątki
utf8Json
jest null
.
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub istnieją pozostałe dane w usłudze Stream.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
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
reprezentacja wartości JSON.
Wyjątki
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.
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.