JsonArray Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class JsonArray final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class JsonArray : IEnumerable<IJsonValue>, IList<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>, IStringablePublic NotInheritable Class JsonArray
Implements IEnumerable(Of IJsonValue), IList(Of IJsonValue), IStringable- Herança
- Atributos
- Implementações
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. |