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 w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do elementu |
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(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 do elementu |
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 do elementu |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu. |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions) |
Analizuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu określonego typu. |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Analizuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Analizuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu |
Deserialize(String, JsonTypeInfo) |
Analizuje tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego |
Deserialize(JsonDocument, JsonTypeInfo) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Analizuje tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego |
Deserialize(JsonNode, JsonTypeInfo) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z udostępnionego czytnika do wystąpienia określonego |
Deserialize(Stream, Type, JsonSerializerOptions) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize(Stream, Type, JsonSerializerContext) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize(JsonElement, JsonTypeInfo) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na wystąpienie określone przez |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do elementu |
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>) |
Konwertuje JsonDocument 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 ogólny parametr typu. |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Konwertuje JsonNode reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego. |
Deserialize<TValue>(String, JsonSerializerOptions) |
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego. |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Analizuje tekst reprezentujący pojedynczą wartość JSON do elementu |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>) |
Analizuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions) |
Analizuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr typu. |
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Analizuje tekst reprezentujący pojedynczą wartość JSON do elementu |
Deserialize(Stream, JsonTypeInfo)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego jsonTypeInfo
przez obiekt .
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 analizowania.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
to 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 elementu 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 z możliwością serializacji.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
lub context
to 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 żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podana context
nie zwróciła zgodnego JsonTypeInfo dla returnType
metody .
Uwagi
TokenType Jeśli właściwość ma reader
wartość PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.
Po zakończeniu tej metody reader
zostanie umieszczony na ostatnim tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany 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 wymogu zachowania integralności danych poza zwróceniem tej metody.
Użyte JsonReaderOptions do utworzenia wystąpienia Utf8JsonReader wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , AllowTrailingCommasMaxDepth, i CommentHandling są używane podczas odczytywania.
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 do odczytania kodu JSON.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializatora podczas odczytywania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
to null
.
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z plikiem JSON.
-lub-
Nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Uwagi
TokenType Jeśli właściwość ma reader
wartość 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
zostanie umieszczony na ostatnim tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany 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 wymogu zachowania integralności danych poza zwróceniem tej metody.
Użyte JsonReaderOptions do utworzenia wystąpienia Utf8JsonReader wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , JsonReaderOptions.AllowTrailingCommasJsonReaderOptions.MaxDepth, i JsonReaderOptions.CommentHandling są używane podczas odczytywania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
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
wartość .
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
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Dotyczy
Deserialize(JsonElement, Type, JsonSerializerContext)
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na returnType
wartość .
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
Element JsonElement do konwersji.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z plikiem JSON.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podanego context
zwraca null
wartość dla typu do przekonwertowania.
Dotyczy
Deserialize(JsonElement, Type, JsonSerializerOptions)
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na returnType
wartość .
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
Element JsonElement do konwersji.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
to null
.
returnType
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Dotyczy
Deserialize(JsonDocument, Type, JsonSerializerContext)
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na returnType
wartość .
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
Element JsonDocument do konwersji.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z plikiem JSON.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podanego context
zwraca null
wartość dla typu do przekonwertowania.
Dotyczy
Deserialize(JsonDocument, Type, JsonSerializerOptions)
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na returnType
wartość .
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
Element JsonDocument do konwersji.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
document
lub returnType
to null
.
returnType
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Dotyczy
Deserialize(String, Type, JsonSerializerContext)
Analizuje tekst reprezentujący pojedynczą wartość JSON w obiekcie 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 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
Reprezentacja returnType
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z plikiem JSON.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podanego context
zwraca null
wartość dla typu do przekonwertowania.
Uwagi
Użycie elementu String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa formatu 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 analizy.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
json
lub returnType
ma wartość null
.
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z formatem JSON.
-lub-
W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Uwagi
Użycie elementu String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa formatu UTF-8.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Dotyczy
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
Analizuje tekst reprezentujący pojedynczą wartość JSON w obiekcie 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 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
Reprezentacja returnType
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z formatem JSON.
-lub-
W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Metoda GetTypeInfo(Type) podanego context
zwraca null
typ, który ma być konwertowany.
Uwagi
Użycie elementu String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa formatu 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 analizy.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
to null
.
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z formatem JSON.
-lub-
Dane pozostają poza pojedynczą wartością JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Uwagi
Użycie zakresu UTF-16 nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa utF-8.
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 wartość reprezentującą pojedynczą wartość JSON na wartość 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
Reprezentacja returnType
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z formatem JSON.
-lub-
W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Metoda GetTypeInfo(Type) podanego context
zwraca null
typ, który ma być konwertowany.
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 w formacie UTF-8 tekst 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 analizy.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
to null
.
Kod JSON jest nieprawidłowy.
-lub-
returnType
jest niezgodny z formatem JSON.
-lub-
Dane pozostają poza pojedynczą wartością JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
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 w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w obiekcie 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 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
Reprezentacja returnType
wartości JSON.
Wyjątki
returnType
to null
.
Kod JSON jest nieprawidłowy, returnType
jest niezgodny z plikiem JSON lub w usłudze Stream pozostają dane.
Nie ma zgodności JsonConverter z elementami członkowskimi, które returnType
można serializować.
Metoda GetTypeInfo(Type) podana context
nie zwróciła zgodnego JsonTypeInfo dla returnType
metody .
Dotyczy
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
- Źródło:
- JsonSerializer.Read.Span.cs
- Źródło:
- JsonSerializer.Read.Span.cs
Analizuje zakodowany w formacie UTF-8 tekst 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 analizy.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy lub istnieją pozostałe dane w buforze.
Dotyczy
Deserialize(String, JsonTypeInfo)
Analizuje tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego jsonTypeInfo
przez obiekt .
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 analizy.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
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 elementu String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa formatu UTF-8.
Dotyczy
Deserialize(JsonDocument, JsonTypeInfo)
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na wystąpienie określone przez jsonTypeInfo
obiekt .
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
Element JsonDocument do konwersji.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
Dotyczy
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
Analizuje tekst reprezentujący pojedynczą wartość JSON do wystąpienia określonego jsonTypeInfo
przez obiekt .
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 analizy.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
jsonTypeInfo
to null
.
Kod JSON jest nieprawidłowy.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Uwagi
Użycie elementu nie String jest tak wydajne, jak użycie metod UTF-8, ponieważ implementacja natywnie używa protokołu UTF-8.
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
obiekt .
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
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
jsonTypeInfo
to null
.
Dotyczy
Deserialize(Utf8JsonReader, JsonTypeInfo)
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z udostępnionego czytnika do wystąpienia określonego jsonTypeInfo
przez obiekt .
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
Reprezentacja jsonTypeInfo
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
TokenType Jeśli właściwość ma reader
wartość PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.
Po zakończeniu tej metody reader
zostanie umieszczony na ostatnim tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany 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 wymogu zachowania integralności danych poza zwróceniem tej metody.
Użyte JsonReaderOptions do utworzenia wystąpienia Utf8JsonReader wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , AllowTrailingCommasMaxDepth, i CommentHandling są używane podczas odczytywania.
Dotyczy
Deserialize(Stream, Type, JsonSerializerOptions)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie 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 analizowania.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas odczytywania.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
utf8Json
lub returnType
to null
.
Kod JSON jest nieprawidłowy, element returnType
nie jest zgodny z plikiem JSON lub w usłudze Stream znajdują się pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Dotyczy
Deserialize(Stream, Type, JsonSerializerContext)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie 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 analizowania.
- returnType
- Type
Typ obiektu, który ma być konwertowany na i zwracany.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Zwraca
Reprezentacja returnType
wartości JSON.
Wyjątki
utf8Json
, returnType
lub context
to null
.
Kod JSON jest nieprawidłowy, element returnType
nie jest zgodny z plikiem JSON lub w usłudze Stream znajdują się pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów returnType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podana context
nie zwróciła zgodnego JsonTypeInfo dla returnType
metody .
Dotyczy
Deserialize(JsonElement, JsonTypeInfo)
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na wystąpienie określone przez jsonTypeInfo
obiekt .
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
Element JsonElement do konwersji.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja jsonTypeInfo
wartości JSON.
Wyjątki
jsonTypeInfo
to null
.
Dotyczy
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
Odczytuje jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika do elementu 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
Reprezentacja TValue
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 żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
TokenType Jeśli właściwość ma reader
wartość PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.
Po zakończeniu tej metody reader
zostanie umieszczony na ostatnim tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany 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 wymogu zachowania integralności danych poza zwróceniem tej metody.
Użyte JsonReaderOptions do utworzenia wystąpienia Utf8JsonReader wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , AllowTrailingCommasMaxDepth, i CommentHandling są używane podczas odczytywania.
Dotyczy
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na TValue
wartość .
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
Element JsonDocument do konwersji.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich 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 ogólny parametr typu.
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Parametry typu
- TValue
Typ docelowy wartości JSON.
Parametry
- reader
- Utf8JsonReader
Czytelnik do odczytania kodu JSON.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializatora podczas odczytywania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
Nie można odczytać wartości z czytnika.
reader
używa nieobsługiwanych opcji.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
TokenType Jeśli właściwość ma reader
wartość 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
zostanie umieszczony na ostatnim tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany 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 wymogu zachowania integralności danych poza zwróceniem tej metody.
Użyte JsonReaderOptions do utworzenia wystąpienia Utf8JsonReader wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , JsonReaderOptions.AllowTrailingCommasJsonReaderOptions.MaxDepth, i JsonReaderOptions.CommentHandling są używane podczas odczytywania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
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
wartość .
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
Reprezentacja TValue
wartości JSON.
Wyjątki
jsonTypeInfo
to null
.
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich 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
wartość .
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
Reprezentacja TValue
wartości JSON.
Wyjątki
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na TValue
wartość .
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
Element JsonElement do konwersji.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
jsonTypeInfo
to null
.
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
Konwertuje JsonElement reprezentującą pojedynczą wartość JSON na TValue
wartość .
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
Element JsonElement do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
Konwertuje JsonDocument reprezentującą pojedynczą wartość JSON na TValue
wartość .
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
Element JsonDocument do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
document
to null
.
TValue
jest niezgodny z plikiem JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego.
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 analizy.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich 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>(String, JsonSerializerOptions)
Analizuje tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez parametr typu ogólnego.
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 analizy.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
json
to null
.
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
Użycie elementu nie String jest tak wydajne, jak użycie metod UTF-8, ponieważ implementacja natywnie używa protokołu UTF-8.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Dotyczy
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
Analizuje tekst reprezentujący pojedynczą wartość JSON do elementu 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 analizy.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
Pozostałe dane w ciągu wykraczają poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
Użycie elementu nie String jest tak wydajne, jak użycie metod UTF-8, ponieważ implementacja natywnie używa protokołu 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 w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w formacie 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 analizy.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy, TValue
nie jest zgodny z plikiem JSON lub w usłudze Stream istnieją pozostałe dane.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich 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 w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w wystąpieniu typu określonego przez ogólny parametr typu.
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Parametry typu
- TValue
Typ docelowy zakodowanego tekstu UTF-8.
Parametry
- utf8Json
- ReadOnlySpan<Byte>
Tekst JSON do analizy.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania podczas analizowania.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z plikiem JSON.
-lub-
Istnieją pozostałe dane w zakresie wykraczającym poza pojedynczą wartość JSON.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
Dotyczy
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w obiekcie 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
Reprezentacja TValue
wartości JSON.
Wyjątki
utf8Json
lub jsonTypeInfo
ma wartość null
.
Kod JSON jest nieprawidłowy, TValue
jest niezgodny z plikiem JSON lub w usłudze Stream pozostają dane.
Nie ma zgodności JsonConverter z elementami członkowskimi, które TValue
można serializować.
Dotyczy
Deserialize<TValue>(Stream, JsonSerializerOptions)
Odczytuje zakodowany w formacie UTF-8 tekst reprezentujący pojedynczą wartość JSON w obiekcie 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
Reprezentacja TValue
wartości JSON.
Wyjątki
utf8Json
to null
.
Kod JSON jest nieprawidłowy, TValue
jest niezgodny z plikiem JSON lub w usłudze Stream pozostają dane.
Nie ma zgodności JsonConverter z elementami członkowskimi, które TValue
można serializować.
Dotyczy
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
Analizuje tekst reprezentujący pojedynczą wartość JSON w obiekcie 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 analizy.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja TValue
wartości JSON.
Wyjątki
Kod JSON jest nieprawidłowy.
-lub-
TValue
jest niezgodny z formatem JSON.
-lub-
W ciągu pozostają dane wykraczające poza pojedynczą wartość JSON.
Nie ma zgodności JsonConverter z elementami członkowskimi, które TValue
można serializować.
Uwagi
Użycie elementu String nie jest tak wydajne, jak używanie metod UTF-8, ponieważ implementacja natywnie używa formatu UTF-8.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla