JsonArray Classe

Definizione

Spazio dei nomi:

Windows.Data.Json

Rappresenta una matrice JSON.

JsonArray eredita le interfacce IVector(IJsonValue) e IIterable(IJsonValue), che forniscono metodi per scorrere gli elementi nella matrice e aggiornarne il contenuto.

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

Ereditarietà

Object Platform::Object IInspectable JsonArray

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per un esempio di come questi metodi di classe vengono usati per analizzare una matrice da una stringa JSON e convertirla in un oggetto JsonArray, aggiornare i valori contenuti nella matrice e quindi serializzare l'oggetto JsonArray aggiornato come stringa JSON, vedere Using JavaScript Object Notation (JSON).

Enumerazione della raccolta in C# o Microsoft Visual Basic

JsonArray è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi nella raccolta. Il compilatore esegue automaticamente il cast dei tipi e non è necessario eseguire il cast in IEnumerable<IJsonValue> modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast a IEnumerable<T> con un vincolo IJsonValue .

Costruttori

JsonArray()

Crea un nuovo oggetto JsonArray che rappresenta una matrice JSON.

Proprietà

Size	Ottiene le dimensioni (conteggio) della matrice.
ValueType	Ottiene il tipo dei valori all'interno della matrice. I tipi possibili sono definiti da JsonValueType.

Metodi

Append(IJsonValue)	Aggiunge un nuovo elemento alla matrice.
Clear()	Rimuove tutti gli elementi dalla raccolta.
First()	Restituisce l'iteratore per l'iterazione sugli elementi nella matrice.
GetArray()	Ottiene JsonArray se valueType del valore incapsulato è Array.
GetArrayAt(UInt32)	Ottiene JsonArray in corrispondenza dell'indice specificato se valueType del valore incapsulato è Array .
GetAt(UInt32)	Restituisce l'elemento che si trova in corrispondenza dell'indice specificato.
GetBoolean()	Ottiene il valore booleano se valueType del valore incapsulato è Boolean.
GetBooleanAt(UInt32)	Ottiene il valore booleano in corrispondenza dell'indice specificato se valueType del valore in corrispondenza di tale indice è booleano.
GetMany(UInt32, IJsonValue[])	Ottiene tutti gli elementi della matrice di tipo IJsonValue, a partire da un indice specificato.
GetNumber()	Ottiene il numero (valore Double) se valueType del valore incapsulato è Number.
GetNumberAt(UInt32)	Ottiene il numero (valore Double) in corrispondenza dell'indice specificato se valueType del valore in corrispondenza di tale indice è Number.
GetObject()	Ottiene l'oggetto JsonObject se valueType del valore incapsulato è Object.
GetObjectAt(UInt32)	Ottiene l'oggetto JsonObject in corrispondenza dell'indice specificato se valueType del valore incapsulato è Object.
GetString()	Ottiene l'oggetto String se valueType del valore incapsulato è String.
GetStringAt(UInt32)	Ottiene l'oggetto String in corrispondenza dell'indice specificato se valueType del valore incapsulato è String.
GetView()	Ottiene una visualizzazione JsonArray .
IndexOf(IJsonValue, UInt32)	Cerca un oggetto JsonValue e restituisce l'indice in base zero della prima occorrenza all'interno di JsonArray.
InsertAt(UInt32, IJsonValue)	Inserisce un valore JsonValue in una matrice in corrispondenza dell'indice specificato.
Parse(String)	Analizza la stringa JSON specificata che rappresenta un oggetto JsonArray. Nota Questo metodo genererà un'eccezione se la stringa JSON specificata non è valida. L'uso di JsonObject.TryParse è un'alternativa consigliata. Una chiamata TryParse restituirà un valore booleano per indicare l'esito positivo o negativo e, in caso di esito positivo, il risultato JsonArray.
RemoveAt(UInt32)	Rimuove l'elemento all'indice della raccolta specificato.
RemoveAtEnd()	Rimuove l'ultimo elemento nella matrice.
ReplaceAll(IJsonValue[])	Cancella la matrice e quindi inserisce la raccolta fornita di oggetti JsonValue come nuovi elementi della matrice.
SetAt(UInt32, IJsonValue)	Imposta il valore in corrispondenza dell'indice specificato usando jsonValue specificato.
Stringify()	Restituisce la rappresentazione JSON del valore incapsulato.
ToString()	Restituisce la rappresentazione JSON del valore incapsulato.
TryParse(String, JsonArray)	Analizza la stringa fornita in jsonArray.

Vedi anche

• Uso di JavaScript Object Notation (JSON)
• Esempio JSON (Windows 10)