JsonObject Kelas

Definisi

Ruang nama:

Windows.Data.Json

Mewakili objek JSON yang berisi kumpulan nama dan pasangan JsonValue .

JsonObject adalah kelas yang dapat diaktifkan yang mengimplementasikan JsonValue dan antarmuka IMap<String,IJsonValue> sehingga pasangan nama/nilainya dapat dimanipulasi seperti kamus. Ketika ada nilai dengan nama duplikat, pasangan nama belakang/nilai akan disimpan.

public ref class JsonObject sealed : IIterable<IKeyValuePair<Platform::String ^, IJsonValue ^> ^>, IMap<Platform::String ^, IJsonValue ^>, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class JsonObject final : IIterable<IKeyValuePair<winrt::hstring, IJsonValue const&>>, IMap<winrt::hstring, IJsonValue const&>, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class JsonObject : IDictionary<string,IJsonValue>, IEnumerable<KeyValuePair<string,IJsonValue>>, IStringable

Public NotInheritable Class JsonObject
Implements IDictionary(Of String, IJsonValue), IEnumerable(Of KeyValuePair(Of String, IJsonValue)), IStringable

Warisan

Object Platform::Object IInspectable JsonObject

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IDictionary<String,IJsonValue> IMap<Platform::String,IJsonValue> IMap<winrt::hstring,IJsonValue> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,IJsonValue>> IIterable<IKeyValuePair<Platform::String,IJsonValue>> IIterable<IKeyValuePair<winrt::hstring,IJsonValue>> IJsonValue IStringable

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Untuk contoh bagaimana metode kelas ini digunakan untuk mengurai objek dari string JSON dan mengonversinya menjadi objek JsonObject, perbarui pasangan nama/nilai yang dikandung objek, lalu serialisasi objek JsonObject yang diperbarui sebagai string JSON, lihat Menggunakan JavaScript Object Notation (JSON).

Konstruktor

JsonObject()

Menginisialisasi instans baru JsonObject yang mewakili objek JSON yang berisi kumpulan nama dan pasangan JsonValue .

Properti

Size	Mendapatkan ukuran (jumlah) koleksi.
ValueType	Mendapatkan jenis nilai JSON yang dienkapsulasi. Jenis yang mungkin ditentukan oleh JsonValueType.

Metode

Clear()	Menghapus semua item dari koleksi.
First()	Mengembalikan iterator untuk perulangan atas pasangan kunci/nilai di JsonObject.
GetArray()	Mengembalikan JsonArray jika ValueType dari nilai yang dienkapsulasi adalah Array.
GetBoolean()	Mendapatkan Boolean jika ValueType dari nilai yang dienkapsulasi adalah Boolean.
GetNamedArray(String)	Mendapatkan nilai JsonArray dengan nama yang ditentukan.
GetNamedArray(String, JsonArray)	Mendapatkan nilai JsonArray dengan nama yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNamedBoolean(String)	Mendapatkan nilai Boolean dengan nama yang ditentukan.
GetNamedBoolean(String, Boolean)	Mendapatkan nilai Boolean dengan nama yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNamedNumber(String)	Mendapatkan nilai angka ( Ganda) dengan nama yang ditentukan.
GetNamedNumber(String, Double)	Mendapatkan nilai angka ( Ganda) dengan nama yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNamedObject(String)	Mendapatkan nilai JsonObject dengan nama yang ditentukan.
GetNamedObject(String, JsonObject)	Mendapatkan nilai JsonObject dengan nama yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNamedString(String)	Mendapatkan nilai String dengan nama yang ditentukan.
GetNamedString(String, String)	Mendapatkan nilai String dengan nama yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNamedValue(String)	Mendapatkan nilai JsonValue dengan nama yang ditentukan.
GetNamedValue(String, JsonValue)	Mendapatkan nilai JsonValue yang ditentukan, atau nilai default yang disediakan jika tidak ada nilai bernama yang ditemukan.
GetNumber()	Mendapatkan angka ( Ganda) jika ValueType dari nilai yang dienkapsulasi adalah Angka.
GetObject()	Mendapatkan JsonObject jika ValueType dari nilai yang dienkapsulasi adalah Object.
GetString()	Mendapatkan String jika ValueType dari nilai yang dienkapsulasi adalah String.
GetView()	Mendapatkan tampilan JsonObject .
HasKey(String)	Menunjukkan apakah JsonObject memiliki entri dengan kunci yang diminta.
Insert(String, IJsonValue)	Menambahkan entri baru ke JsonObject.
Lookup(String)	Mendapatkan nilai JSON yang terkait dengan kunci yang disediakan, jika ada entri dengan kunci tersebut.
Parse(String)	Mengurai string JSON yang ditentukan yang mewakili JsonObject ke dalam nilai JSON. Catatan Ini akan melemparkan pengecualian jika string JSON yang disediakan tidak valid. Penggunaan JsonObject.TryParse adalah alternatif yang direkomendasikan. Panggilan TryParse akan mengembalikan nilai boolean untuk menunjukkan keberhasilan atau kegagalan dan, jika berhasil, JsonObject yang dihasilkan.
Remove(String)	Menghapus item tertentu dari JsonObject.
SetNamedValue(String, IJsonValue)	Mengatur nilai objek JsonValue pertama dengan nama yang ditentukan ke nilai yang ditentukan. Jika tidak ada objek seperti itu yang ditemukan, nama baru dan pasangan JsonValue dimasukkan ke dalam objek JSON.
Stringify()	Mengambil representasi JSON dari nilai yang dienkapsulasi.
ToString()	Mengambil representasi JSON dari nilai yang dienkapsulasi.
TryParse(String, JsonObject)	Mengurai string yang ditentukan yang mewakili objek JSON ke dalam JsonObject.

Lihat juga

• Menggunakan JavaScript Object Notation (JSON)
• Sampel JSON (Windows 10)