JsonObject Класс

Определение

Пространство имен:

Windows.Data.Json

Представляет объект JSON, содержащий коллекцию пар name и JsonValue .

JsonObject — это активируемый класс, который реализует JsonValue и интерфейс IMap<String,IJsonValue> таким образом, что их парами "имя-значение" можно управлять как словарем. При наличии значений с повторяющимися именами сохраняется пара "фамилия-значение".

public ref class JsonObject sealed : IIterable<IKeyValuePair<Platform::String ^, IJsonValue ^> ^>, IMap<Platform::String ^, 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 JsonObject final : IIterable<IKeyValuePair<winrt::hstring, IJsonValue const&>>, IMap<winrt::hstring, IJsonValue const&>, 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 JsonObject : IDictionary<string,IJsonValue>, IEnumerable<KeyValuePair<string,IJsonValue>>, IStringable

Public NotInheritable Class JsonObject
Implements IDictionary(Of String, IJsonValue), IEnumerable(Of KeyValuePair(Of String, IJsonValue)), IStringable

Наследование

Object Platform::Object IInspectable JsonObject

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IDictionary<String,IJsonValue> IMap<Platform::String,IJsonValue> IMap<winrt::hstring,IJsonValue> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,IJsonValue>> IIterable<IKeyValuePair<Platform::String,IJsonValue>> IIterable<IKeyValuePair<winrt::hstring,IJsonValue>> IJsonValue IStringable

Требования к Windows

Требования	Описание
Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Пример того, как эти методы класса используются для анализа объекта из строки JSON и преобразования его в объект JsonObject, обновления пар "имя-значение", содержащихся в объекте, а затем сериализации обновленного объекта JsonObject в виде строки JSON, см. в разделе Использование нотации объектов JavaScript (JSON) .

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

Имя	Описание
JsonObject()	Инициализирует новый экземпляр JsonObject , представляющий объект JSON, содержащий коллекцию пар name и JsonValue .

Свойства

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

Методы

Имя	Описание
Clear()	Удаляет все элементы из коллекции.
First()	Возвращает итератор для итерации пар "ключ-значение" в JsonObject.
GetArray()	Возвращает jsonArray, если значение ValueType инкапсулированного значения — Array.
GetBoolean()	Возвращает логическое значение, если значение ValueType инкапсулированного значения имеет значение Boolean.
GetNamedArray(String)	Возвращает значение JsonArray с указанным именем.
GetNamedArray(String, JsonArray)	Возвращает значение JsonArray с указанным именем или указанное значение по умолчанию, если такое именованное значение не найдено.
GetNamedBoolean(String)	Возвращает логическое значение с указанным именем.
GetNamedBoolean(String, Boolean)	Возвращает логическое значение с указанным именем или указанное значение по умолчанию, если такое именованное значение не найдено.
GetNamedNumber(String)	Возвращает числовое значение ( Double) с указанным именем.
GetNamedNumber(String, Double)	Возвращает числовое значение ( Double) с указанным именем или указанное значение по умолчанию, если такое именованное значение не найдено.
GetNamedObject(String)	Возвращает значение JsonObject с указанным именем.
GetNamedObject(String, JsonObject)	Возвращает значение JsonObject с указанным именем или указанное значение по умолчанию, если такое именованное значение не найдено.
GetNamedString(String)	Возвращает значение String с указанным именем.
GetNamedString(String, String)	Возвращает значение String с указанным именем или указанное значение по умолчанию, если такое именованное значение не найдено.
GetNamedValue(String)	Возвращает значение JsonValue с указанным именем.
GetNamedValue(String, JsonValue)	Возвращает указанное значение JsonValue или предоставленное значение по умолчанию, если такое именованное значение не найдено.
GetNumber()	Возвращает число ( Double), если значение ValueType инкапсулированного значения — Number.
GetObject()	Возвращает объект JsonObject , если значение ValueType инкапсулированного значения — Object.
GetString()	Возвращает значение String , если значение ValueType инкапсулированного значения — String.
GetView()	Возвращает представление JsonObject .
HasKey(String)	Указывает, содержит ли JsonObject запись с запрошенным ключом.
Insert(String, IJsonValue)	Добавляет новую запись в JsonObject.
Lookup(String)	Возвращает значение JSON, связанное с предоставленным ключом, если существует запись с этим ключом.
Parse(String)	Анализирует указанную строку JSON, представляющую JsonObject , в значение JSON. Примечание Это приведет к возникновению исключения, если указанная строка JSON недопустима. Рекомендуется использовать JsonObject.TryParse . Вызов TryParse вернет логическое значение, указывающее на успех или сбой, а в случае успеха — результирующий объект JsonObject.
Remove(String)	Удаляет определенный элемент из JsonObject.
SetNamedValue(String, IJsonValue)	Задает указанное значение для первого объекта JsonValue с указанным именем. Если такой объект не найден, в объект JSON вставляется новое имя и пара JsonValue .
Stringify()	Извлекает представление инкапсулированного значения в формате JSON.
ToString()	Извлекает представление инкапсулированного значения в формате JSON.
TryParse(String, JsonObject)	Анализирует указанную строку, представляющую объект JSON, в JsonObject.

См. также раздел

• Использование нотации объектов JavaScript (JSON)
• Пример JSON (Windows 10)