JsonArray クラス

定義

名前空間:

Windows.Data.Json

JSON 配列を表します。

JsonArray は 、配列内の要素を反復処理してその内容を更新するメソッドを提供する IVector(IJsonValue ) インターフェイスと IIterable(IJsonValue) インターフェイスを継承します。

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

継承

Object Platform::Object IInspectable JsonArray

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<IJsonValue> IJsonValue IStringable

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

これらのクラス メソッドを使用して JSON 文字列から配列を解析し、JsonArray オブジェクトに変換し、配列に含まれる値を更新し、更新された JsonArray オブジェクトを JSON 文字列としてシリアル化する方法の例については、「 Using JavaScript Object Notation (JSON)」を参照してください。

C# または Microsoft Visual Basic でのコレクションの列挙

JsonArray は列挙可能であるため、C# の foreach などの言語固有の構文を使用して、コレクション内の項目を列挙できます。 コンパイラは型キャストを行います。明示的に キャストする IEnumerable<IJsonValue> 必要はありません。 GetEnumerator を呼び出す場合など、明示的にキャストする必要がある場合は、IJsonValue 制約を使用して IEnumerable<T> にキャストします。

コンストラクター

JsonArray()

JSON 配列を表す新しい JsonArray オブジェクトを作成します。

プロパティ

Size	配列のサイズ (カウント) を取得します。
ValueType	配列内の値の型を取得します。 使用できる型は 、JsonValueType によって定義されます。

メソッド

Append(IJsonValue)	配列に新しい項目を追加します。
Clear()	コレクションからすべての項目を削除します。
First()	配列内の項目を反復処理するための反復子を返します。
GetArray()	カプセル化された値の ValueType が Array の場合は、JsonArray を取得します。
GetArrayAt(UInt32)	カプセル化された値の ValueType が Array の場合、指定したインデックス位置にある JsonArray を取得します。
GetAt(UInt32)	指定したインデックスにある項目を返します。
GetBoolean()	カプセル化された値の ValueType が Boolean の場合は、ブール値を取得します。
GetBooleanAt(UInt32)	指定したインデックスの値の ValueType が Boolean の場合、指定したインデックスのブール値を取得します。
GetMany(UInt32, IJsonValue[])	指定したインデックスから始まる IJsonValue 型のすべての配列項目を取得します。
GetNumber()	カプセル化された値の ValueType が Number の場合、数値 (Double) を取得します。
GetNumberAt(UInt32)	指定したインデックスの値の ValueType が Number の場合、指定したインデックスの数値 (Double) を取得します。
GetObject()	カプセル化された値の ValueType が Object の場合、JsonObjectを取得します。
GetObjectAt(UInt32)	カプセル化された値の ValueType が Object の場合、指定したインデックス位置にある JsonObjectを取得します。
GetString()	カプセル化された値の ValueType が String の場合は、String を取得します。
GetStringAt(UInt32)	カプセル化された値の ValueType が String の場合は、指定したインデックス位置にある String を取得します。
GetView()	JsonArray ビューを取得します。
IndexOf(IJsonValue, UInt32)	JsonValue オブジェクトを検索し、JsonArray 内で最初に出現する 0 から始まるインデックスを返します。
InsertAt(UInt32, IJsonValue)	指定したインデックス位置の配列に JsonValue を挿入します。
Parse(String)	JsonArray を表す指定した JSON 文字列を解析します。 Note 指定された JSON 文字列が無効な場合、このメソッドは例外をスローします。 JsonObject.TryParse を使用することをお勧めします。 TryParse 呼び出しは、成功または失敗を示すブール値を返し、成功した場合は結果の JsonArray を返します。
RemoveAt(UInt32)	コレクションの指定したインデックス位置にある 要素を削除します。
RemoveAtEnd()	配列内の最後の項目を削除します。
ReplaceAll(IJsonValue[])	配列をクリアし、 指定された JsonValue オブジェクトのコレクションを新しい配列項目として挿入します。
SetAt(UInt32, IJsonValue)	指定した JsonValue を使用して、指定したインデックスの値を設定します。
Stringify()	カプセル化された値の JSON 表現を返します。
ToString()	カプセル化された値の JSON 表現を返します。
TryParse(String, JsonArray)	指定された文字列を JsonArray に解析します。

こちらもご覧ください

• JavaScript オブジェクト表記 (JSON) の使用
• JSON サンプル (Windows 10)