JsonArray Classe

Definição

Namespace:

Windows.Data.Json

Representa uma matriz JSON.

JsonArray herda as interfaces IVector(IJsonValue) e IIterable(IJsonValue), que fornecem métodos para iterar pelos elementos na matriz e atualizar seu conteúdo.

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

Herança

Object Platform::Object IInspectable JsonArray

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IIterable<T> IEnumerable<T> IIterable<IJsonValue> IEnumerable<IJsonValue> IVector<IJsonValue> IList<IJsonValue> IJsonValue IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Para obter um exemplo de como esses métodos de classe são usados para analisar uma matriz de uma cadeia de caracteres JSON e convertê-la em um objeto JsonArray, atualizar os valores que a matriz contém e serializar o objeto JsonArray atualizado como uma cadeia de caracteres JSON, consulte Using JavaScript Object Notation (JSON).

Enumerando a coleção em C# ou Microsoft Visual Basic

Uma JsonArray é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C# para enumerar os itens na coleção. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<IJsonValue> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição IJsonValue .

Construtores

JsonArray()

Cria um novo objeto JsonArray que representa uma matriz JSON.

Propriedades

Size	Obtém o tamanho (contagem) da matriz.
ValueType	Obtém o tipo dos valores dentro da matriz. Os tipos possíveis são definidos por JsonValueType.

Métodos

Append(IJsonValue)	Adiciona um novo item à matriz.
Clear()	Remove todos os itens da coleção.
First()	Retorna o iterador para iteração sobre os itens na matriz.
GetArray()	Obtém o JsonArray se o ValueType do valor encapsulado for Array.
GetArrayAt(UInt32)	Obtém o JsonArray no índice especificado se o ValueType do valor encapsulado for Array .
GetAt(UInt32)	Retorna o item localizado no índice especificado.
GetBoolean()	Obtém o valor booliano se o ValueType do valor encapsulado for booliano.
GetBooleanAt(UInt32)	Obtém o valor booliano no índice especificado se o ValueType do valor nesse índice for booliano.
GetMany(UInt32, IJsonValue[])	Obtém todos os itens de matriz do tipo IJsonValue, começando de um índice especificado.
GetNumber()	Obtém o número (um Duplo) se o ValueType do valor encapsulado for Number.
GetNumberAt(UInt32)	Obtém o número (um Double) no índice especificado se o ValueType do valor nesse índice for Number.
GetObject()	Obtém o JsonObject se o ValueType do valor encapsulado for Object.
GetObjectAt(UInt32)	Obtém o JsonObject no índice especificado se o ValueType do valor encapsulado for Object.
GetString()	Obtém a cadeia de caracteres se o ValueType do valor encapsulado for String.
GetStringAt(UInt32)	Obtém a cadeia de caracteres no índice especificado se o ValueType do valor encapsulado for String.
GetView()	Obtém uma exibição JsonArray .
IndexOf(IJsonValue, UInt32)	Pesquisa um objeto JsonValue e retorna o índice baseado em zero de sua primeira ocorrência no JsonArray.
InsertAt(UInt32, IJsonValue)	Insere um JsonValue em uma matriz no índice especificado.
Parse(String)	Analisa a cadeia de caracteres JSON especificada que representa um JsonArray. Observação Esse método gerará uma exceção se a cadeia de caracteres JSON fornecida não for válida. O uso de JsonObject.TryParse é uma alternativa recomendada. Uma chamada TryParse retornará um valor booliano para indicar êxito ou falha e, se tiver êxito, o JsonArray resultante.
RemoveAt(UInt32)	Remove o elemento no índice especificado da coleção.
RemoveAtEnd()	Remove o último item na matriz.
ReplaceAll(IJsonValue[])	Limpa a matriz e insere a coleção fornecida de objetos JsonValue como novos itens de matriz.
SetAt(UInt32, IJsonValue)	Define o valor no índice especificado usando o JsonValue fornecido.
Stringify()	Retorna a representação JSON do valor encapsulado.
ToString()	Retorna a representação JSON do valor encapsulado.
TryParse(String, JsonArray)	Analisa a cadeia de caracteres fornecida em um JsonArray.

Confira também

• Usando JSON (JavaScript Object Notation)
• Exemplo de JSON (Windows 10)