JsonSerializer.Deserialize Metode

Definisi

Ruang nama:

System.Text.Json

Rakitan:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-preview.3.24172.9

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(Utf8JsonReader, Type, JsonSerializerOptions)	Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan dan mengonversinya menjadi instans jenis tertentu.
Deserialize(JsonNode, Type, JsonSerializerOptions)	JsonNode Mengonversi yang mewakili satu nilai JSON menjadi returnType.
Deserialize(JsonElement, Type, JsonSerializerContext)	JsonElement Mengonversi yang mewakili satu nilai JSON menjadi returnType.
Deserialize(JsonElement, Type, JsonSerializerOptions)	JsonElement Mengonversi yang mewakili satu nilai JSON menjadi returnType.
Deserialize(JsonDocument, Type, JsonSerializerContext)	JsonDocument Mengonversi yang mewakili satu nilai JSON menjadi returnType.
Deserialize(JsonDocument, Type, JsonSerializerOptions)	JsonDocument Mengonversi 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(JsonNode, Type, JsonSerializerContext)	JsonNode Mengonversi yang mewakili satu nilai JSON menjadi returnType.
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu.
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(String, JsonTypeInfo)	Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo.
Deserialize(JsonDocument, JsonTypeInfo)	JsonDocument Mengonversi yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo.
Deserialize(JsonNode, JsonTypeInfo)	JsonNode Mengonversi yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.
Deserialize(Utf8JsonReader, JsonTypeInfo)	Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans yang ditentukan oleh jsonTypeInfo.
Deserialize(Stream, Type, JsonSerializerOptions)	Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.
Deserialize(Stream, Type, JsonSerializerContext)	Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType. Stream akan dibaca hingga selesai.
Deserialize(JsonElement, JsonTypeInfo)	JsonElement Mengonversi yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo.
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam TValue.
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	JsonDocument Mengonversi 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>(JsonNode, JsonTypeInfo<TValue>)	JsonNode Mengonversi yang mewakili satu nilai JSON menjadi TValue.
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	JsonNode Mengonversi yang mewakili satu nilai JSON menjadi TValue.
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	JsonElement Mengonversi yang mewakili satu nilai JSON menjadi TValue.
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	JsonElement Mengonversi yang mewakili satu nilai JSON menjadi TValue.
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	JsonDocument Mengonversi yang mewakili satu nilai JSON menjadi TValue.
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.
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>, JsonTypeInfo<TValue>)	Mengurai teks yang mewakili satu nilai JSON ke dalam TValue.
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 nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau jsonTypeInfo adalah null.

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 nilai JSON.

Pengecualian

ArgumentNullException

returnType atau context adalah null.

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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

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

Keterangan

TokenType Jika properti adalah readerPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke untuk Read() 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.

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

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 dari 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 nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

TokenType Jika properti adalah readerJsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke untuk Utf8JsonReader.Read() 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.

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

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

Deserialize(JsonNode, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Node.cs

JsonNode Mengonversi 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

yang akan dikonversi JsonNode .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize(JsonElement, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Read.Element.cs

JsonElement Mengonversi 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

yang akan dikonversi JsonElement .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

-atau-

contextadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

Deserialize(JsonElement, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Element.cs

JsonElement Mengonversi 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

yang akan dikonversi JsonElement .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize(JsonDocument, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Read.Document.cs

JsonDocument Mengonversi 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

yang akan dikonversi JsonDocument .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

documentadalah null.

-atau-

returnTypeadalah null.

-atau-

contextadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Document.cs

JsonDocument Mengonversi 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

yang akan dikonversi JsonDocument .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

document atau returnType adalah null.

JsonException

returnType tidak kompatibel dengan JSON.

NotSupportedException

Tidak ada yang kompatibel JsonConverter 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 nilai JSON.

Pengecualian

ArgumentNullException

json atau returnType adalah null.

-atau-

contextadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

Keterangan

String Menggunakan 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 yang akan diurai.

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

json atau returnType adalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

Keterangan

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

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi 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 nilai JSON.

Pengecualian

ArgumentNullException

json atau returnType adalah null.

-atau-

contextadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

Keterangan

String Menggunakan 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 yang akan diurai.

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

Keterangan

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

Deserialize(JsonNode, Type, JsonSerializerContext)

Sumber:

JsonSerializer.Read.Node.cs

JsonNode Mengonversi 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

yang akan dikonversi JsonNode .

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

context

JsonSerializerContext

Penyedia metadata untuk jenis yang dapat diserialisasikan.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

-atau-

contextadalah 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 yang kompatibel JsonConverter untuk returnType atau anggotanya yang dapat diserialisasikan.

InvalidOperationException

Metode GetTypeInfo(Type) pengembalian yang disediakan contextnull untuk jenis yang akan dikonversi.

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 yang akan diurai.

returnType

Type

Jenis objek yang akan dikonversi ke dan dikembalikan.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

Object

Representasi returnType nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

JsonException

JSON tidak valid.

-atau-

returnType tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

Keterangan

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

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 nilai JSON.

Pengecualian

ArgumentNullException

returnTypeadalah null.

JsonException

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

NotSupportedException

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

InvalidOperationException

Metode GetTypeInfo(Type) pada yang disediakan context tidak mengembalikan kompatibel JsonTypeInfo 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 nilai JSON.

Pengecualian

JsonException

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

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 nilai JSON.

Pengecualian

ArgumentNullException

jsonadalah null.

-atau-

jsonTypeInfoadalah null.

JsonException

JSON tidak valid.

-atau-

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

Keterangan

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

Deserialize(JsonDocument, JsonTypeInfo)

Sumber:

JsonSerializer.Read.Document.cs

JsonDocument Mengonversi 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

yang akan dikonversi JsonDocument .

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Object

Representasi jsonTypeInfo nilai JSON.

Pengecualian

ArgumentNullException

documentadalah null.

-atau-

jsonTypeInfoadalah null.

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 nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

JsonException

JSON tidak valid.

-atau-

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

Keterangan

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

Deserialize(JsonNode, JsonTypeInfo)

Sumber:

JsonSerializer.Read.Node.cs

JsonNode Mengonversi 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

yang akan dikonversi JsonNode .

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Object

Representasi jsonTypeInfo nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

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

TokenType Jika properti adalah readerPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke untuk Read() 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.

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

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 nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau returnType adalah null.

JsonException

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

NotSupportedException

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

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 nilai JSON.

Pengecualian

ArgumentNullException

utf8Json, returnType, atau context adalah null.

JsonException

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

NotSupportedException

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

InvalidOperationException

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

Deserialize(JsonElement, JsonTypeInfo)

Sumber:

JsonSerializer.Read.Element.cs

JsonElement Mengonversi 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

yang akan dikonversi JsonElement .

jsonTypeInfo

JsonTypeInfo

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

Object

Representasi jsonTypeInfo nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

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 ke dalamnya.

Parameter

reader

Utf8JsonReader

Pembaca yang akan dibaca.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue 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 yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

TokenType Jika properti adalah readerPropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke untuk Read() 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.

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

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

Sumber:

JsonSerializer.Read.Document.cs

JsonDocument Mengonversi 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 ke dalamnya.

Parameter

document

JsonDocument

yang akan dikonversi JsonDocument .

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

ArgumentNullException

documentadalah null.

-atau-

jsonTypeInfoadalah null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

Tidak ada yang kompatibel JsonConverter 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 nilai JSON.

Parameter

reader

Utf8JsonReader

Pembaca untuk membaca JSON dari.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku serializer selama membaca.

Mengembalikan

TValue

Representasi TValue 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 yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

TokenType Jika properti adalah readerJsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke untuk Utf8JsonReader.Read() 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.

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

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

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

Sumber:

JsonSerializer.Read.Node.cs

JsonNode Mengonversi 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

yang akan dikonversi JsonNode .

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Node.cs

JsonNode Mengonversi 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

yang akan dikonversi JsonNode .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

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

Sumber:

JsonSerializer.Read.Element.cs

JsonElement Mengonversi 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

yang akan dikonversi JsonElement .

jsonTypeInfo

JsonTypeInfo<TValue>

Metadata tentang jenis yang akan dikonversi.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

ArgumentNullException

jsonTypeInfoadalah null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Element.cs

JsonElement Mengonversi 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

yang akan dikonversi JsonElement .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Sumber:

JsonSerializer.Read.Document.cs

JsonDocument Mengonversi 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

yang akan dikonversi JsonDocument .

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

ArgumentNullException

documentadalah null.

JsonException

TValue tidak kompatibel dengan JSON.

NotSupportedException

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

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 nilai JSON.

Pengecualian

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

Keterangan

Menggunakan rentang UTF-16 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 nilai JSON.

Parameter

json

String

Teks JSON untuk diurai.

options

JsonSerializerOptions

Opsi untuk mengontrol perilaku selama penguraian.

Mengembalikan

TValue

Representasi TValue nilai JSON.

Pengecualian

ArgumentNullException

jsonadalah 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 yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

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

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

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 nilai JSON.

Pengecualian

ArgumentNullException

jsonadalah null.

-atau-

jsonTypeInfoadalah 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 yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

String Menggunakan 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 nilai JSON.

Pengecualian

JsonException

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

NotSupportedException

Tidak ada yang kompatibel JsonConverter 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 nilai JSON.

Pengecualian

JsonException

JSON tidak valid.

-atau-

TValue tidak kompatibel dengan JSON.

-atau-

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

NotSupportedException

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

Keterangan

Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan deserialisasi 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 nilai JSON.

Pengecualian

ArgumentNullException

utf8Json atau jsonTypeInfo adalah null.

JsonException

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

NotSupportedException

Tidak ada yang kompatibel JsonConverter 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 nilai JSON.

Pengecualian

ArgumentNullException

utf8Jsonadalah null.

JsonException

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

NotSupportedException

Tidak ada yang kompatibel JsonConverter 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 nilai JSON.

Pengecualian

ArgumentNullException

jsonadalah null.

-atau-

jsonTypeInfoadalah 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 yang kompatibel JsonConverter untuk TValue atau anggotanya yang dapat diserialisasikan.

Keterangan

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