JsonSerializer.Deserialize Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

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

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau jsonTypeInfonull.

JsonException

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

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType atau contextnull.

JsonException

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

ArgumentException

reader menggunakan opsi yang tidak didukung.

NotSupportedException

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

InvalidOperationException

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.

Deserialize(JsonNode, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

-atau-

context null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonNode, Type, JsonSerializerOptions)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize(JsonElement, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

-atau-

context null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonElement, Type, JsonSerializerOptions)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize(JsonDocument, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

document null.

-atau-

returnType null.

-atau-

context null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonDocument, Type, JsonSerializerOptions)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

document atau returnTypenull.

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize(String, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

json atau returnTypenull.

-atau-

context null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

InvalidOperationException

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.

Deserialize(String, Type, JsonSerializerOptions)

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);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

json atau returnTypenull.

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

json atau returnTypenull.

-atau-

context null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

InvalidOperationException

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.

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

NotSupportedException

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.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

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);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Nilai tidak dapat dibaca dari pembaca.

ArgumentException

reader menggunakan opsi yang tidak didukung.

NotSupportedException

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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

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);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

NotSupportedException

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

Keterangan

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

Deserialize(Stream, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json, returnType, atau contextnull.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(Stream, Type, JsonSerializerOptions)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau returnTypenull.

JsonException

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

NotSupportedException

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

Deserialize(Utf8JsonReader, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

JsonException

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

ArgumentException

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.

Deserialize(JsonNode, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfo null.

Deserialize(JsonElement, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfo null.

Deserialize(JsonDocument, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

document null.

-atau-

jsonTypeInfo null.

Deserialize(String, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

json null.

-atau-

jsonTypeInfo null.

JsonException

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.

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfo null.

JsonException

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.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

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

Object

Representasi returnType dari nilai JSON.

Pengecualian

ArgumentNullException

returnType null.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

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

Object

Representasi jsonTypeInfo dari nilai JSON.

Pengecualian

JsonException

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

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

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

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

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

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

ArgumentNullException

jsonTypeInfo null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

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

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

JsonException

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

ArgumentException

reader menggunakan opsi yang tidak didukung.

NotSupportedException

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.

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

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

ArgumentNullException

jsonTypeInfo null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

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);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

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

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Nilai tidak dapat dibaca dari pembaca.

ArgumentException

reader menggunakan opsi yang tidak didukung.

NotSupportedException

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.

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

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

ArgumentNullException

document null.

-atau-

jsonTypeInfo null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

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

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

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

ArgumentNullException

document null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

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

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

ArgumentNullException

json null.

-atau-

jsonTypeInfo null.

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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.

Deserialize<TValue>(String, JsonSerializerOptions)

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);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

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

ArgumentNullException

json null.

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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.

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

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

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

NotSupportedException

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.

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

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

JsonException

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

NotSupportedException

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

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

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);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

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

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

Ada data yang tersisa dalam rentang melebihi satu nilai JSON.

NotSupportedException

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

Keterangan

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

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

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

ArgumentNullException

utf8Json atau jsonTypeInfonull.

JsonException

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

NotSupportedException

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

Deserialize<TValue>(Stream, JsonSerializerOptions)

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

ArgumentNullException

utf8Json null.

JsonException

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

NotSupportedException

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

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

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

ArgumentNullException

json null.

-atau-

jsonTypeInfo null.

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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.