JsonArray Kelas

Definisi

Ruang nama:

Windows.Data.Json

Mewakili array JSON.

JsonArray mewarisi antarmuka IVector(IJsonValue) dan IIterable(IJsonValue), yang menyediakan metode untuk melakukan iterasi melalui elemen dalam array dan memperbarui kontennya.

public ref class JsonArray sealed : IIterable<IJsonValue ^>, IVector<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 JsonArray final : IIterable<IJsonValue>, IVector<IJsonValue>, 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 JsonArray : IEnumerable<IJsonValue>, IList<IJsonValue>, IStringable

Public NotInheritable Class JsonArray
Implements IEnumerable(Of IJsonValue), IList(Of IJsonValue), IStringable

Warisan

Object Platform::Object IInspectable JsonArray

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<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 array dari string JSON dan mengonversinya menjadi objek JsonArray, memperbarui nilai yang dikandung array, lalu membuat serialisasi objek JsonArray yang diperbarui sebagai string JSON, lihat Menggunakan JavaScript Object Notation (JSON).

Menghitung koleksi dalam C# atau Microsoft Visual Basic

JsonArray dapat dijumlahkan, sehingga Anda dapat menggunakan sintaksis khusus bahasa seperti foreach dalam C# untuk menghitung item dalam koleksi. Pengkompilasi melakukan pengecoran jenis untuk Anda dan Anda tidak perlu mentransmisian secara IEnumerable<IJsonValue> eksplisit. Jika Anda perlu mentransmisikan secara eksplisit, misalnya jika Anda ingin memanggil GetEnumerator, transmisikan ke IEnumerable<T> dengan batasan IJsonValue .

Konstruktor

JsonArray()

Membuat objek JsonArray baru yang mewakili array JSON.

Properti

Size	Mendapatkan ukuran (hitungan) array.
ValueType	Mendapatkan jenis nilai dalam array. Jenis yang mungkin ditentukan oleh JsonValueType.

Metode

Append(IJsonValue)	Menambahkan item baru ke array.
Clear()	Menghapus semua item dari koleksi.
First()	Mengembalikan iterator untuk iterasi atas item dalam array.
GetArray()	Mendapatkan JsonArray jika ValueType dari nilai yang dienkapsulasi adalah Array.
GetArrayAt(UInt32)	Mendapatkan JsonArray pada indeks yang ditentukan jika ValueType dari nilai yang dienkapsulasi adalah Array .
GetAt(UInt32)	Mengembalikan item yang terletak di indeks yang ditentukan.
GetBoolean()	Mendapatkan nilai Boolean jika ValueType dari nilai yang dienkapsulasi adalah Boolean.
GetBooleanAt(UInt32)	Mendapatkan nilai Boolean pada indeks yang ditentukan jika ValueType dari nilai di indeks tersebut adalah Boolean.
GetMany(UInt32, IJsonValue[])	Mendapatkan semua item array jenis IJsonValue, mulai dari indeks tertentu.
GetNumber()	Mendapatkan angka ( Ganda) jika ValueType dari nilai yang dienkapsulasi adalah Angka.
GetNumberAt(UInt32)	Mendapatkan angka ( Ganda) pada indeks yang ditentukan jika ValueType dari nilai di indeks tersebut adalah Angka.
GetObject()	Mendapatkan JsonObject jika ValueType dari nilai yang dienkapsulasi adalah Objek.
GetObjectAt(UInt32)	Mendapatkan JsonObject pada indeks yang ditentukan jika ValueType dari nilai yang dienkapsulasi adalah Objek.
GetString()	Mendapatkan String jika ValueType dari nilai yang dienkapsulasi adalah String.
GetStringAt(UInt32)	Mendapatkan String pada indeks yang ditentukan jika ValueType dari nilai yang dienkapsulasi adalah String.
GetView()	Mendapatkan tampilan JsonArray .
IndexOf(IJsonValue, UInt32)	Mencari objek JsonValue dan mengembalikan indeks berbasis nol dari kemunculan pertamanya dalam JsonArray.
InsertAt(UInt32, IJsonValue)	Menyisipkan JsonValue ke dalam array pada indeks yang ditentukan.
Parse(String)	Mengurai string JSON yang ditentukan yang mewakili JsonArray. Catatan Metode ini akan memberikan 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, JsonArray yang dihasilkan.
RemoveAt(UInt32)	Menghapus elemen pada indeks koleksi yang ditentukan.
RemoveAtEnd()	Menghapus item terakhir dalam array.
ReplaceAll(IJsonValue[])	Menghapus array lalu menyisipkan koleksi objek JsonValue yang disediakan sebagai item array baru.
SetAt(UInt32, IJsonValue)	Mengatur nilai pada indeks yang ditentukan menggunakan JsonValue yang disediakan.
Stringify()	Mengembalikan representasi JSON dari nilai yang dienkapsulasi.
ToString()	Mengembalikan representasi JSON dari nilai yang dienkapsulasi.
TryParse(String, JsonArray)	Mengurai string yang disediakan menjadi JsonArray.

Lihat juga

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