JsonObject 클래스

정의

네임스페이스:

Windows.Data.Json

이름 및 JsonValue 쌍의 컬렉션을 포함하는 JSON 개체를 나타냅니다.

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 문자열로 serialize합니다. JSON(JavaScript Object Notation) 사용을 참조하세요.

생성자

JsonObject()

이름 및 JsonValue 쌍의 컬렉션을 포함하는 JSON 개체를 나타내는 JsonObject의 새 instance 초기화합니다.

속성

Size	컬렉션의 크기(개수)를 가져옵니다.
ValueType	캡슐화된 JSON 값의 형식을 가져옵니다. 가능한 형식은 JsonValueType으로 정의됩니다.

메서드

Clear()	컬렉션에서 모든 항목을 제거합니다.
First()	JsonObject의 키/값 쌍에 대한 반복기를 반환합니다.
GetArray()	캡슐화된 값의 ValueType이 Array이면 JsonArray를 반환합니다.
GetBoolean()	캡슐화된 값의 ValueType이 부울이면 부울을 가져옵니다.
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()	캡슐화된 값의 ValueType이 Number이면 숫자(Double)를 가져옵니다.
GetObject()	캡슐화된 값의 ValueType이 Object이면 JsonObject를 가져옵니다.
GetString()	캡슐화된 값의 ValueType이 String인 경우 String을 가져옵니다.
GetView()	JsonObject 뷰를 가져옵니다.
HasKey(String)	JsonObject에 요청된 키가 있는 항목이 있는지 여부를 나타냅니다.
Insert(String, IJsonValue)	JsonObject에 새 항목을 추가합니다.
Lookup(String)	해당 키가 있는 항목이 있는 경우 제공된 키와 연결된 JSON 값을 가져옵니다.
Parse(String)	JsonObject를 나타내는 지정된 JSON 문자열을 JSON 값으로 구문 분석합니다. 참고 제공된 JSON 문자열이 유효하지 않으면 예외가 throw됩니다. JsonObject.TryParse를 사용하는 것이 좋습니다. TryParse 호출은 성공 또는 실패를 나타내고 성공하면 결과 JsonObject를 나타내는 부울 값을 반환합니다.
Remove(String)	JsonObject에서 특정 항목을 제거합니다.
SetNamedValue(String, IJsonValue)	지정한 이름을 가진 첫 번째 JsonValue 개체의 값을 지정된 값으로 설정합니다. 이러한 개체를 찾을 수 없으면 새 이름과 JsonValue 쌍이 JSON 개체에 삽입됩니다.
Stringify()	캡슐화된 값의 JSON 표현을 검색합니다.
ToString()	캡슐화된 값의 JSON 표현을 검색합니다.
TryParse(String, JsonObject)	JSON 개체를 나타내는 지정된 문자열을 JsonObject로 구문 분석합니다.

추가 정보

• JSON(JavaScript Object Notation) 사용
• JSON 샘플(Windows 10)