Bagikan melalui


JsonSerializer.Deserialize Metode

Definisi

Overload

Deserialize(Stream, JsonTypeInfo)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo. Stream akan dibaca hingga selesai.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam returnType.

Deserialize(JsonNode, Type, JsonSerializerContext)

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi returnType.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi returnType.

Deserialize(JsonElement, Type, JsonSerializerContext)

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi returnType.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi returnType.

Deserialize(JsonDocument, Type, JsonSerializerContext)

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi returnType.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi returnType.

Deserialize(String, Type, JsonSerializerContext)

Mengurai teks yang mewakili satu nilai JSON ke dalam returnType.

Deserialize(String, Type, JsonSerializerOptions)

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Mengurai teks yang mewakili satu nilai JSON ke dalam returnType.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan dan mengonversinya menjadi instans jenis tertentu.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

Deserialize(Stream, Type, JsonSerializerContext)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.

Deserialize(Stream, Type, JsonSerializerOptions)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.

Deserialize(Utf8JsonReader, JsonTypeInfo)

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans yang ditentukan oleh jsonTypeInfo.

Deserialize(JsonNode, JsonTypeInfo)

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.

Deserialize(JsonElement, JsonTypeInfo)

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.

Deserialize(JsonDocument, JsonTypeInfo)

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.

Deserialize(String, JsonTypeInfo)

Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType.

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo.

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi TValue.

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

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi TValue.

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

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam TValue.

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

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi TValue.

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi TValue.

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi TValue.

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi TValue.

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

Mengurai teks yang mewakili satu nilai JSON ke dalam TValue.

Deserialize<TValue>(String, JsonSerializerOptions)

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue.

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

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.

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

Mengurai teks yang mewakili satu nilai JSON ke dalam TValue.

Deserialize(Stream, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo. Stream akan dibaca hingga selesai.

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

Parameter

utf8Json
Stream

Data JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

utf8Json atau jsonTypeInfonull.

JSON tidak valid, atau ada data yang tersisa di Stream.

Berlaku untuk

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam 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

Parameter

reader
Utf8JsonReader

Pembaca yang akan dibaca.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType atau contextnull.

JSON tidak valid, returnType tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.

reader menggunakan opsi yang tidak didukung.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) pada context yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType.

Keterangan

Jika properti TokenTypereaderPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.

JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.

Berlaku untuk

Deserialize(JsonNode, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi 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

Parameter

node
JsonNode

JsonNode yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

-atau-

context null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Berlaku untuk

Deserialize(JsonNode, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi 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

Parameter

node
JsonNode

JsonNode yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize(JsonElement, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi 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

Parameter

element
JsonElement

JsonElement yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

-atau-

context null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Berlaku untuk

Deserialize(JsonElement, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi 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

Parameter

element
JsonElement

JsonElement yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

returnType tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize(JsonDocument, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi 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

Parameter

document
JsonDocument

JsonDocument yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

document null.

-atau-

returnType null.

-atau-

context null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Berlaku untuk

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi 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

Parameter

document
JsonDocument

JsonDocument yang akan dikonversi.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

document atau returnTypenull.

returnType tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize(String, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam 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

Parameter

json
String

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

json atau returnTypenull.

-atau-

context null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize(String, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

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

Parameter

json
String

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

json atau returnTypenull.

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam 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

Parameter

json
ReadOnlySpan<Char>

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

json atau returnTypenull.

-atau-

context null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) dari context yang disediakan mengembalikan null untuk jenis yang akan dikonversi.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

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

Parameter

json
ReadOnlySpan<Char>

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan rentang UTF-16 tidak seefisien menggunakan metode UTF-8 karena implementasi secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan dan mengonversinya menjadi instans jenis tertentu.

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

Parameter

reader
Utf8JsonReader

Pembaca untuk membaca JSON dari.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku serializer selama membaca.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Nilai tidak dapat dibaca dari pembaca.

reader menggunakan opsi yang tidak didukung.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

Jika properti TokenTypereaderJsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke Utf8JsonReader.Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.

JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, dan JsonReaderOptions.CommentHandling digunakan saat membaca.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu.

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

Parameter

utf8Json
ReadOnlySpan<Byte>

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

Deserialize(Stream, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.

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

Parameter

utf8Json
Stream

Data JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

utf8Json, returnType, atau contextnull.

JSON tidak valid, returnType tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) pada context yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType.

Berlaku untuk

Deserialize(Stream, Type, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.

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

Parameter

utf8Json
Stream

Data JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama membaca.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

utf8Json atau returnTypenull.

JSON tidak valid, returnType tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize(Utf8JsonReader, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans yang ditentukan oleh 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

Parameter

reader
Utf8JsonReader

Pembaca yang akan dibaca.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

JSON tidak valid, jsonTypeInfo tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.

reader menggunakan opsi yang tidak didukung.

Keterangan

Jika properti TokenTypereaderPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.

JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.

Berlaku untuk

Deserialize(JsonNode, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh 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

Parameter

node
JsonNode

JsonNode yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

jsonTypeInfo null.

Berlaku untuk

Deserialize(JsonElement, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh 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

Parameter

element
JsonElement

JsonElement yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

jsonTypeInfo null.

Berlaku untuk

Deserialize(JsonDocument, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh 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

Parameter

document
JsonDocument

JsonDocument yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

document null.

-atau-

jsonTypeInfo null.

Berlaku untuk

Deserialize(String, JsonTypeInfo)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh 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

Parameter

json
String

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

json null.

-atau-

jsonTypeInfo null.

JSON tidak valid.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh 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

Parameter

json
ReadOnlySpan<Char>

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

jsonTypeInfo null.

JSON tidak valid.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam 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

Parameter

utf8Json
ReadOnlySpan<Byte>

Teks JSON untuk diurai.

returnType
Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context
JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Representasi returnType dari nilai JSON.

Pengecualian

returnType null.

JSON tidak valid, returnType tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk returnType atau anggotanya yang dapat diserialisasikan.

Metode GetTypeInfo(Type) pada context yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType.

Berlaku untuk

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh 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

Parameter

utf8Json
ReadOnlySpan<Byte>

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

JSON tidak valid, atau ada data yang tersisa di buffer.

Berlaku untuk

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

element
JsonElement

JsonElement yang akan dikonversi.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs
Sumber:
JsonSerializer.Read.Element.cs

Mengonversi JsonElement yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

element
JsonElement

JsonElement yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

jsonTypeInfo null.

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

reader
Utf8JsonReader

Pembaca yang akan dibaca.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid, TValue tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.

reader menggunakan opsi yang tidak didukung.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Jika properti TokenTypereaderPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.

JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

node
JsonNode

JsonNode yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

jsonTypeInfo null.

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs
Sumber:
JsonSerializer.Read.Utf8JsonReader.cs

Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Jenis parameter

TValue

Jenis target dari nilai JSON.

Parameter

reader
Utf8JsonReader

Pembaca untuk membaca JSON dari.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku serializer selama membaca.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Nilai tidak dapat dibaca dari pembaca.

reader menggunakan opsi yang tidak didukung.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Jika properti TokenTypereaderJsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke Utf8JsonReader.Read() untuk menentukan awal nilai.

Setelah menyelesaikan metode ini, reader akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.

Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.

JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, dan JsonReaderOptions.CommentHandling digunakan saat membaca.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

document
JsonDocument

JsonDocument yang akan dikonversi.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

document null.

-atau-

jsonTypeInfo null.

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs
Sumber:
JsonSerializer.Read.Node.cs

Mengonversi JsonNode yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

node
JsonNode

JsonNode yang akan dikonversi.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs
Sumber:
JsonSerializer.Read.Document.cs

Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

document
JsonDocument

JsonDocument yang akan dikonversi.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

document null.

TValue tidak kompatibel dengan JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

json
ReadOnlySpan<Char>

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

json null.

-atau-

jsonTypeInfo null.

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk

Deserialize<TValue>(String, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Jenis parameter

TValue

Jenis target dari nilai JSON.

Parameter

json
String

Teks JSON untuk diurai.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

json
ReadOnlySpan<Char>

Teks JSON untuk diurai.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan rentang UTF-16 tidak seefisien menggunakan metode UTF-8 karena implementasi secara asli menggunakan UTF-8.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

utf8Json
ReadOnlySpan<Byte>

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid, TValue tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs
Sumber:
JsonSerializer.Read.Span.cs

Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.

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

Jenis parameter

TValue

Jenis target teks yang dikodekan UTF-8.

Parameter

utf8Json
ReadOnlySpan<Byte>

Teks JSON untuk diurai.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.

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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

utf8Json
Stream

Data JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

utf8Json atau jsonTypeInfonull.

JSON tidak valid, TValue tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

Deserialize<TValue>(Stream, JsonSerializerOptions)

Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs
Sumber:
JsonSerializer.Read.Stream.cs

Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue. Stream akan dibaca hingga selesai.

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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

utf8Json
Stream

Data JSON untuk diurai.

options
JsonSerializerOptions

Opsi untuk mengontrol perilaku selama membaca.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

utf8Json null.

JSON tidak valid, TValue tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Berlaku untuk

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

Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs
Sumber:
JsonSerializer.Read.String.cs

Mengurai teks yang mewakili satu nilai JSON ke dalam 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

Jenis parameter

TValue

Jenis untuk mendeserialisasi nilai JSON.

Parameter

json
String

Teks JSON untuk diurai.

jsonTypeInfo
JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue dari nilai JSON.

Pengecualian

json null.

-atau-

jsonTypeInfo null.

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam string di luar satu nilai JSON.

Tidak ada JsonConverter yang kompatibel untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.

Berlaku untuk