JsonArray 類別

定義

表示 JSON 陣列。

JsonArray 會繼承 IJsonValue (IJsonValue) IIterable (IJsonValue) 介面,以提供方法逐一查看陣列中的元素並更新其內容。

public ref class JsonArray sealed : IIterable<IJsonValue ^>, IVector<IJsonValue ^>, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class JsonArray final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class JsonArray : IEnumerable<IJsonValue>, IList<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
屬性
實作

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()

如果封裝值的ValueTypeArray,則取得JsonArray

GetArrayAt(UInt32)

如果封裝值的ValueTypeArray ,則取得位於指定索引處的JsonArray

GetAt(UInt32)

傳回位於指定索引處的專案。

GetBoolean()

如果封裝值的ValueTypeBoolean,則取得布林值。

GetBooleanAt(UInt32)

如果位於該索引之值的ValueTypeBoolean,則取得位於指定索引的布林值。

GetMany(UInt32, IJsonValue[])

從指定的索引開始,取得 IJsonValue類型的所有陣列專案。

GetNumber()

如果封裝值的ValueType為 (Number,則取得Double) 數位

GetNumberAt(UInt32)

如果位於該索引之值的ValueType為 Number,則取得在指定索引處的Double) 數位 (數位

GetObject()

如果封裝值的ValueTypeObject,則取得JsonObject

GetObjectAt(UInt32)

如果封裝值的ValueTypeObject,則取得位於指定索引處的JsonObject

GetString()

如果封裝值的ValueTypeString,則取得String

GetStringAt(UInt32)

如果封裝值的ValueType為 String,則取得位於指定索引處的String

GetView()

取得 JsonArray 檢視。

IndexOf(IJsonValue, UInt32)

搜尋 JsonValue 物件,並傳回其在 JsonArray中第一次出現的以零起始的索引。

InsertAt(UInt32, IJsonValue)

JsonValue 插入陣列中指定的索引處。

Parse(String)

剖析代表 JsonArray的指定 JSON 字串。

注意

如果提供的 JSON 字串無效,這個方法會擲回例外狀況。 建議使用 JsonObject.TryParseTryParse呼叫會傳回布林值,以指出成功或失敗,如果成功,則為產生的JsonArray

RemoveAt(UInt32)

移除集合的指定索引處的項目。

RemoveAtEnd()

移除陣列中的最後一個專案。

ReplaceAll(IJsonValue[])

清除陣列,然後將提供的 JsonValue 物件集合插入為新的陣列專案。

SetAt(UInt32, IJsonValue)

使用提供的 JsonValue,在指定的索引處設定值。

Stringify()

傳回封裝值的 JSON 表示。

ToString()

傳回封裝值的 JSON 表示。

TryParse(String, JsonArray)

將提供的字串剖析為 JsonArray

適用於

另請參閱