JsonArray 類別

定義

命名空間:

Windows.Data.Json

表示 JSON 陣列。

JsonArray 會繼承 IJsonValue (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 字串，請參閱 使用 JavaScript 物件標記法 (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中第一次出現的以零起始的索引。
InsertAt(UInt32, IJsonValue)	將 JsonValue 插入陣列中指定的索引處。
Parse(String)	剖析代表 JsonArray的指定 JSON 字串。 注意 如果提供的 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)