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 문자열로 직렬화하는 방법에 대한 예제는 JSON(JavaScript Object Notation) 사용을 참조하세요.

C# 또는 Microsoft Visual Basic에서 컬렉션 열거

JsonArray는 열거 가능하므로 C#의 foreach 와 같은 언어별 구문을 사용하여 컬렉션의 항목을 열거할 수 있습니다. 컴파일러는 형식 캐스팅을 수행하므로 명시적으로 캐스팅 IEnumerable<IJsonValue> 할 필요가 없습니다. 예를 들어 GetEnumerator를 호출하려는 경우 명시적으로 캐스팅해야 하는 경우 IJsonValue 제약 조건을 사용하여 IEnumerable<T>로 캐스팅합니다.

생성자

JsonArray()

JSON 배열을 나타내는 새 JsonArray 개체를 만듭니다.

속성

Size	배열의 크기(개수)를 가져옵니다.
ValueType	배열 내 값의 형식을 가져옵니다. 가능한 형식은 JsonValueType에 의해 정의됩니다.

메서드

Append(IJsonValue)	배열에 새 항목을 추가합니다.
Clear()	컬렉션에서 모든 항목을 제거합니다.
First()	배열의 항목을 반복하기 위한 반복기를 반환합니다.
GetArray()	캡슐화된 값의 ValueType이 Array이면 JsonArray를 가져옵니다.
GetArrayAt(UInt32)	캡슐화된 값의 ValueType이 Array 인 경우 지정된 인덱스에서 JsonArray를 가져옵니다.
GetAt(UInt32)	지정된 인덱스 에 있는 항목을 반환합니다.
GetBoolean()	캡슐화된 값의 ValueType이 부울인 경우 부울 값을 가져옵니다.
GetBooleanAt(UInt32)	해당 인덱스 값의 ValueType이 부울인 경우 지정된 인덱스에서 부울 값을 가져옵니다.
GetMany(UInt32, IJsonValue[])	지정된 인덱스에서 시작하여 IJsonValue 형식의 모든 배열 항목을 가져옵니다.
GetNumber()	캡슐화된 값의 ValueType이 Number이면 숫자(Double)를 가져옵니다.
GetNumberAt(UInt32)	해당 인덱스 값의 ValueType이 Number인 경우 지정된 인덱스의 숫자(Double)를 가져옵니다.
GetObject()	캡슐화된 값의 ValueType이 Object이면 JsonObject를 가져옵니다.
GetObjectAt(UInt32)	캡슐화된 값의 ValueType이 Object인 경우 지정된 인덱스에서 JsonObject를 가져옵니다.
GetString()	캡슐화된 값의 ValueType이 String이면 String을 가져옵니다.
GetStringAt(UInt32)	캡슐화된 값의 ValueType이 String인 경우 지정된 인덱스의 String을 가져옵니다.
GetView()	JsonArray 뷰를 가져옵니다.
IndexOf(IJsonValue, UInt32)	JsonValue 개체를 검색하고 JsonArray 내에서 처음 발생하는 인덱스(0부터 시작)를 반환합니다.
InsertAt(UInt32, IJsonValue)	지정된 인덱스의 배열에 JsonValue 를 삽입합니다.
Parse(String)	JsonArray를 나타내는 지정된 JSON 문자열을 구문 분석합니다. 참고 제공된 JSON 문자열이 잘못된 경우 이 메서드는 예외를 throw합니다. JsonObject.TryParse를 사용하는 것이 좋습니다. TryParse 호출은 성공 또는 실패를 나타내기 위해 부울 값을 반환하고, 성공하면 결과 JsonArray를 반환합니다.
RemoveAt(UInt32)	지정된 컬렉션 인덱스에 있는 요소를 제거합니다.
RemoveAtEnd()	배열의 마지막 항목을 제거합니다.
ReplaceAll(IJsonValue[])	배열을 지운 다음 제공된 JsonValue 개체 컬렉션을 새 배열 항목으로 삽입합니다.
SetAt(UInt32, IJsonValue)	제공된 JsonValue를 사용하여 지정된 인덱스의 값을 설정합니다.
Stringify()	캡슐화된 값의 JSON 표현을 반환합니다.
ToString()	캡슐화된 값의 JSON 표현을 반환합니다.
TryParse(String, JsonArray)	제공된 문자열을 JsonArray로 구문 분석합니다.

추가 정보

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