JsonArray Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет массив JSON.
JsonArray наследует интерфейсы IVector(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
- Наследование
- Атрибуты
- Реализации
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Пример использования этих методов класса для синтаксического анализа массива из строки JSON и преобразования его в объект JsonArray, обновления значений, содержащихся в массиве, а затем сериализации обновленного объекта JsonArray в виде строки JSON, см. в разделе Использование нотации объектов JavaScript (JSON).
JsonArray является перечисляемым, поэтому для перечисления элементов в коллекции можно использовать синтаксис для конкретного языка, например foreach в C#. Компилятор выполняет приведение типов автоматически, и вам не нужно явно приводить к IEnumerable<IJsonValue>
. Если необходимо выполнить приведение явным образом, например, если вы хотите вызвать GetEnumerator, приведите к IEnumerable<T> с ограничением IJsonValue .
Json |
Создает новый объект JsonArray , представляющий массив JSON. |
Size |
Возвращает размер (количество) массива. |
Value |
Возвращает тип значений в массиве. Возможные типы определяются JsonValueType. |
Append(IJson |
Добавляет новый элемент в массив. |
Clear() |
Удаляет все элементы из коллекции. |
First() |
Возвращает итератор для итерации по элементам в массиве. |
Get |
Возвращает jsonArray, если valueType инкапсулированного значения — Array. |
Get |
Возвращает JsonArray по указанному индексу, если valueType инкапсулированного значения — Array . |
Get |
Возвращает элемент, расположенный по указанному индексу. |
Get |
Возвращает логическое значение, если valueType инкапсулированного значения имеет значение Boolean. |
Get |
Возвращает логическое значение по указанному индексу, если valueType значения по указанному индексу является логическим. |
Get |
Возвращает все элементы массива типа IJsonValue, начиная с указанного индекса. |
Get |
Возвращает число ( Double), если valueType инкапсулированного значения — Number. |
Get |
Возвращает число ( double) по указанному индексу, если valueType значения по указанному индексу имеет значение Number. |
Get |
Возвращает JsonObject , если valueType инкапсулированного значения — Object. |
Get |
Возвращает объект JsonObject по указанному индексу, если valueType инкапсулированного значения — Object. |
Get |
Возвращает значение String , если значение ValueType инкапсулированного значения — String. |
Get |
Возвращает значение String по указанному индексу, если значение ValueType инкапсулированного значения — String. |
Get |
Возвращает представление JsonArray . |
Index |
Выполняет поиск объекта JsonValue и возвращает отсчитываемый от нуля индекс его первого вхождения в JsonArray. |
Insert |
Вставляет jsonValue в массив по указанному индексу. |
Parse(String) |
Анализирует указанную строку JSON, представляющую JsonArray. Примечание Этот метод создает исключение, если указанная строка JSON недопустима. Рекомендуется использовать JsonObject.TryParse . Вызов TryParse возвращает логическое значение, указывающее на успешное или неудачное выполнение, а в случае успешного выполнения — результирующий объект JsonArray. |
Remove |
Удаляет элемент из коллекции по указанному индексу. |
Remove |
Удаляет последний элемент в массиве. |
Replace |
Очищает массив, а затем вставляет предоставленную коллекцию объектов JsonValue в качестве новых элементов массива. |
Set |
Задает значение по указанному индексу, используя предоставленный jsonValue. |
Stringify() |
Возвращает представление JSON инкапсулированного значения. |
To |
Возвращает представление JSON инкапсулированного значения. |
Try |
Анализирует предоставленную строку в JsonArray. |