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, см. в разделе Использование нотации объектов JavaScript (JSON).

Перечисление коллекции на C# или Microsoft Visual Basic

JsonArray является перечисляемым, поэтому для перечисления элементов в коллекции можно использовать синтаксис для конкретного языка, например foreach в C#. Компилятор выполняет приведение типов автоматически, и вам не нужно явно приводить к IEnumerable<IJsonValue> . Если необходимо выполнить приведение явным образом, например, если вы хотите вызвать GetEnumerator, приведите к IEnumerable<T> с ограничением IJsonValue .

Конструкторы

JsonArray()

Создает новый объект JsonArray , представляющий массив JSON.

Свойства

Size	Возвращает размер (количество) массива.
ValueType	Возвращает тип значений в массиве. Возможные типы определяются JsonValueType.

Методы

Append(IJsonValue)	Добавляет новый элемент в массив.
Clear()	Удаляет все элементы из коллекции.
First()	Возвращает итератор для итерации по элементам в массиве.
GetArray()	Возвращает jsonArray, если valueType инкапсулированного значения — Array.
GetArrayAt(UInt32)	Возвращает JsonArray по указанному индексу, если valueType инкапсулированного значения — Array .
GetAt(UInt32)	Возвращает элемент, расположенный по указанному индексу.
GetBoolean()	Возвращает логическое значение, если valueType инкапсулированного значения имеет значение Boolean.
GetBooleanAt(UInt32)	Возвращает логическое значение по указанному индексу, если valueType значения по указанному индексу является логическим.
GetMany(UInt32, IJsonValue[])	Возвращает все элементы массива типа IJsonValue, начиная с указанного индекса.
GetNumber()	Возвращает число ( Double), если valueType инкапсулированного значения — Number.
GetNumberAt(UInt32)	Возвращает число ( double) по указанному индексу, если valueType значения по указанному индексу имеет значение Number.
GetObject()	Возвращает JsonObject , если valueType инкапсулированного значения — Object.
GetObjectAt(UInt32)	Возвращает объект JsonObject по указанному индексу, если valueType инкапсулированного значения — Object.
GetString()	Возвращает значение String , если значение ValueType инкапсулированного значения — String.
GetStringAt(UInt32)	Возвращает значение String по указанному индексу, если значение ValueType инкапсулированного значения — String.
GetView()	Возвращает представление JsonArray .
IndexOf(IJsonValue, UInt32)	Выполняет поиск объекта JsonValue и возвращает отсчитываемый от нуля индекс его первого вхождения в JsonArray.
InsertAt(UInt32, IJsonValue)	Вставляет jsonValue в массив по указанному индексу.
Parse(String)	Анализирует указанную строку JSON, представляющую JsonArray. Примечание Этот метод создает исключение, если указанная строка 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)