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)