JsonSerializer.Deserialize Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
Deserialize(Stream, JsonTypeInfo) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi |
Deserialize(JsonNode, Type, JsonSerializerOptions) |
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi |
Deserialize(JsonElement, Type, JsonSerializerContext) |
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi |
Deserialize(JsonElement, Type, JsonSerializerOptions) |
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi |
Deserialize(JsonDocument, Type, JsonSerializerContext) |
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi |
Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi |
Deserialize(String, Type, JsonSerializerContext) |
Mengurai teks yang mewakili satu nilai JSON ke dalam |
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 |
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 |
Deserialize(Stream, Type, JsonSerializerOptions) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans yang ditentukan oleh |
Deserialize(JsonNode, JsonTypeInfo) |
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh |
Deserialize(JsonElement, JsonTypeInfo) |
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh |
Deserialize(JsonDocument, JsonTypeInfo) |
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh |
Deserialize(String, JsonTypeInfo) |
Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi |
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 |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Mengurai teks yang mewakili satu nilai JSON ke dalam |
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 |
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 |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Mengurai teks yang mewakili satu nilai JSON ke dalam |
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.
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- utf8Json
- Stream
Data JSON untuk diurai.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
utf8Json
atau jsonTypeInfo
null
.
JSON tidak valid, atau ada data yang tersisa di Stream.
Berlaku untuk
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam returnType
.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- reader
- Utf8JsonReader
Pembaca yang akan dibaca.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
atau context
null
.
JSON tidak valid, returnType
tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.
reader
menggunakan opsi yang tidak didukung.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pada context
yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType
.
Keterangan
Jika properti TokenTypereader
PropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.
Setelah menyelesaikan metode ini, reader
diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.
Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.
JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.
Berlaku untuk
Deserialize(JsonNode, Type, JsonSerializerContext)
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) dari context
yang disediakan mengembalikan null
untuk jenis yang akan dikonversi.
Berlaku untuk
Deserialize(JsonNode, Type, JsonSerializerOptions)
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi returnType
.
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize(JsonElement, Type, JsonSerializerContext)
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- element
- JsonElement
JsonElement yang akan dikonversi.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) dari context
yang disediakan mengembalikan null
untuk jenis yang akan dikonversi.
Berlaku untuk
Deserialize(JsonElement, Type, JsonSerializerOptions)
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi returnType
.
public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- element
- JsonElement
JsonElement yang akan dikonversi.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
null
.
returnType
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize(JsonDocument, Type, JsonSerializerContext)
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi returnType
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- document
- JsonDocument
JsonDocument yang akan dikonversi.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) dari context
yang disediakan mengembalikan null
untuk jenis yang akan dikonversi.
Berlaku untuk
Deserialize(JsonDocument, Type, JsonSerializerOptions)
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi returnType
.
public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- document
- JsonDocument
JsonDocument yang akan dikonversi.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
document
atau returnType
null
.
returnType
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize(String, Type, JsonSerializerContext)
Mengurai teks yang mewakili satu nilai JSON ke dalam returnType
.
public:
static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- json
- String
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) dari context
yang disediakan mengembalikan null
untuk jenis yang akan dikonversi.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize(String, Type, JsonSerializerOptions)
Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.
public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- json
- String
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
json
atau returnType
null
.
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)
Mengurai teks yang mewakili satu nilai JSON ke dalam returnType
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object
Parameter
- json
- ReadOnlySpan<Char>
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) dari context
yang disediakan mengembalikan null
untuk jenis yang akan dikonversi.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)
Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis tertentu.
public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- json
- ReadOnlySpan<Char>
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
null
.
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam rentang melebihi satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan rentang UTF-16 tidak seefisien menggunakan metode UTF-8 karena implementasi secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan dan mengonversinya menjadi instans jenis tertentu.
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- reader
- Utf8JsonReader
Pembaca untuk membaca JSON dari.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serializer selama membaca.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
null
.
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Nilai tidak dapat dibaca dari pembaca.
reader
menggunakan opsi yang tidak didukung.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Keterangan
Jika properti TokenTypereader
JsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke Utf8JsonReader.Read() untuk menentukan awal nilai.
Setelah menyelesaikan metode ini, reader
akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.
Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.
JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, dan JsonReaderOptions.CommentHandling digunakan saat membaca.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis tertentu.
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
public static object Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
null
.
JSON tidak valid.
-atau-
returnType
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam rentang melebihi satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Keterangan
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize(Stream, Type, JsonSerializerContext)
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType
.
Stream akan dibaca hingga selesai.
public:
static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object
Parameter
- utf8Json
- Stream
Data JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
utf8Json
, returnType
, atau context
null
.
JSON tidak valid, returnType
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pada context
yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType
.
Berlaku untuk
Deserialize(Stream, Type, JsonSerializerOptions)
Membaca teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType
.
Stream akan dibaca hingga selesai.
public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj
Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Parameter
- utf8Json
- Stream
Data JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama membaca.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
utf8Json
atau returnType
null
.
JSON tidak valid, returnType
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize(Utf8JsonReader, JsonTypeInfo)
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans yang ditentukan oleh jsonTypeInfo
.
public:
static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- reader
- Utf8JsonReader
Pembaca yang akan dibaca.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
JSON tidak valid, jsonTypeInfo
tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.
reader
menggunakan opsi yang tidak didukung.
Keterangan
Jika properti TokenTypereader
PropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.
Setelah menyelesaikan metode ini, reader
akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.
Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.
JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.
Berlaku untuk
Deserialize(JsonNode, JsonTypeInfo)
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
jsonTypeInfo
null
.
Berlaku untuk
Deserialize(JsonElement, JsonTypeInfo)
Mengonversi JsonElement yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- element
- JsonElement
JsonElement yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
jsonTypeInfo
null
.
Berlaku untuk
Deserialize(JsonDocument, JsonTypeInfo)
Mengonversi JsonDocument yang mewakili satu nilai JSON menjadi instans yang ditentukan oleh jsonTypeInfo
.
public:
[System::Runtime::CompilerServices::Extension]
static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- document
- JsonDocument
JsonDocument yang akan dikonversi.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
Berlaku untuk
Deserialize(String, JsonTypeInfo)
Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo
.
public:
static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- json
- String
Teks JSON untuk diurai.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)
Mengurai teks yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- json
- ReadOnlySpan<Char>
Teks JSON untuk diurai.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
jsonTypeInfo
null
.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam returnType
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);
static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Teks JSON untuk diurai.
- returnType
- Type
Jenis objek yang akan dikonversi ke dan dikembalikan.
- context
- JsonSerializerContext
Penyedia metadata untuk jenis yang dapat diserialisasikan.
Mengembalikan
Representasi returnType
dari nilai JSON.
Pengecualian
returnType
null
.
JSON tidak valid, returnType
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk returnType
atau anggotanya yang dapat diserialisasikan.
Metode GetTypeInfo(Type) pada context
yang disediakan tidak mengembalikan JsonTypeInfo yang kompatibel untuk returnType
.
Berlaku untuk
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans yang ditentukan oleh jsonTypeInfo
.
public:
static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);
public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj
Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Teks JSON untuk diurai.
- jsonTypeInfo
- JsonTypeInfo
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi jsonTypeInfo
dari nilai JSON.
Pengecualian
JSON tidak valid, atau ada data yang tersisa di buffer.
Berlaku untuk
Deserialize<TValue>(JsonElement, JsonSerializerOptions)
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
Representasi TValue
dari nilai JSON.
Pengecualian
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
jsonTypeInfo
null
.
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid, TValue
tidak kompatibel dengan JSON, atau nilai tidak dapat dibaca dari pembaca.
reader
menggunakan opsi yang tidak didukung.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Jika properti TokenTypereader
PropertyName atau None, pembaca akan dimajukan oleh satu panggilan ke Read() untuk menentukan awal nilai.
Setelah menyelesaikan metode ini, reader
diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.
Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.
JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, AllowTrailingCommas, MaxDepth, dan CommentHandling digunakan saat membaca.
Berlaku untuk
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi TValue
.
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Jenis parameter
- TValue
Jenis untuk mendeserialisasi nilai JSON.
Parameter
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
jsonTypeInfo
null
.
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)
Membaca satu nilai JSON (termasuk objek atau array) dari pembaca yang disediakan ke dalam instans jenis yang ditentukan oleh parameter jenis generik.
public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Jenis parameter
- TValue
Jenis target dari nilai JSON.
Parameter
- reader
- Utf8JsonReader
Pembaca untuk membaca JSON dari.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku serializer selama membaca.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Nilai tidak dapat dibaca dari pembaca.
reader
menggunakan opsi yang tidak didukung.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Jika properti TokenTypereader
JsonTokenType.PropertyName atau JsonTokenType.None, pembaca akan dimajukan oleh satu panggilan ke Utf8JsonReader.Read() untuk menentukan awal nilai.
Setelah menyelesaikan metode ini, reader
akan diposisikan pada token akhir dalam nilai JSON. Jika pengecualian dilemparkan, pembaca diatur ulang ke status saat metode dipanggil.
Metode ini membuat salinan data yang ditindaklanjuti pembaca, sehingga tidak ada persyaratan pemanggil untuk mempertahankan integritas data di luar pengembalian metode ini.
JsonReaderOptions yang digunakan untuk membuat instans Utf8JsonReader lebih diutamakan daripada JsonSerializerOptions ketika bertentangan. Oleh karena itu, JsonReaderOptions.AllowTrailingCommas, JsonReaderOptions.MaxDepth, dan JsonReaderOptions.CommentHandling digunakan saat membaca.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(JsonNode, JsonSerializerOptions)
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
- Sumber:
- JsonSerializer.Read.Node.cs
Mengonversi JsonNode yang mewakili satu nilai JSON menjadi TValue
.
public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);
static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value
<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue
Jenis parameter
- TValue
Jenis untuk mendeserialisasi nilai JSON.
Parameter
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)
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
Representasi TValue
dari nilai JSON.
Pengecualian
document
null
.
TValue
tidak kompatibel dengan JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize<TValue>(String, JsonSerializerOptions)
Mengurai teks yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.
public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Jenis parameter
- TValue
Jenis target dari nilai JSON.
Parameter
- json
- String
Teks JSON untuk diurai.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
json
null
.
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)
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
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam rentang melebihi satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan rentang UTF-16 tidak seefisien menggunakan metode UTF-8 karena implementasi secara asli menggunakan UTF-8.
Berlaku untuk
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam TValue
.
public:
generic <typename TValue>
static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue
Jenis parameter
- TValue
Jenis untuk mendeserialisasi nilai JSON.
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Teks JSON untuk diurai.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata tentang jenis yang akan dikonversi.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid, TValue
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
- Sumber:
- JsonSerializer.Read.Span.cs
Mengurai teks yang dikodekan UTF-8 yang mewakili satu nilai JSON ke dalam instans jenis yang ditentukan oleh parameter jenis generik.
public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
Jenis parameter
- TValue
Jenis target teks yang dikodekan UTF-8.
Parameter
- utf8Json
- ReadOnlySpan<Byte>
Teks JSON untuk diurai.
- options
- JsonSerializerOptions
Opsi untuk mengontrol perilaku selama penguraian.
Mengembalikan
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam rentang melebihi satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Untuk informasi selengkapnya, lihat Cara membuat serialisasi dan mendeserialisasi JSON.
Berlaku untuk
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
utf8Json
atau jsonTypeInfo
null
.
JSON tidak valid, TValue
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(Stream, JsonSerializerOptions)
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
Representasi TValue
dari nilai JSON.
Pengecualian
utf8Json
null
.
JSON tidak valid, TValue
tidak kompatibel dengan JSON, atau ada data yang tersisa di Stream.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Berlaku untuk
Deserialize<TValue>(String, JsonTypeInfo<TValue>)
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
Representasi TValue
dari nilai JSON.
Pengecualian
JSON tidak valid.
-atau-
TValue
tidak kompatibel dengan JSON.
-atau-
Ada data yang tersisa dalam string di luar satu nilai JSON.
Tidak ada JsonConverter yang kompatibel untuk TValue
atau anggotanya yang dapat diserialisasikan.
Keterangan
Menggunakan String tidak seefisien menggunakan metode UTF-8 karena implementasinya secara asli menggunakan UTF-8.