Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

JsonTokenType — druh tokenu JSON

JsonTokenType je výčet v System.Text.Json, který popisuje token rozpoznaný třídou Utf8JsonReader. Rozlišuje hranice objektů a polí, názvy vlastností a hodnoty. None označuje stav před čtením, nikoli hodnotu JSON null.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

JsonTokenType tokenType = reader.TokenType;
if (tokenType == JsonTokenType.Null) { /* ... */ }

JsonTokenType v System.Text.Json popisuje druh tokenu. Utf8JsonReader.TokenType zpřístupňuje druh naposledy zpracovaného tokenu; kontrolujte tuto vlastnost po úspěšném volání Read().

StartObject a EndObject označují hranice objektu; StartArray a EndArray označují hranice pole. PropertyName označuje název vlastnosti, nikoli její řetězcovou hodnotu: tu představuje String. Další druhy hodnot jsou Number, True, False a Null.

None je počáteční stav před čtením dat a liší se od tokenu Null. Comment představuje komentář, ale vyžaduje JsonCommentHandling.Allow. Výchozí hodnota Disallow komentáře odmítá; Skip je přeskočí, aniž by zpřístupnila tokeny.

Příklad nejprve vypíše None a poté druhy následujících tokenů. Cyklus pokračuje, dokud Read() vrací true. Neplatný JSON může vyvolat JsonException, místo aby cyklus pouze skončil.

Příklady

using System;
using System.Text.Json;

var reader = new Utf8JsonReader("{\"name\":\"Ada\",\"active\":true,\"note\":null}"u8);
Console.WriteLine(reader.TokenType);

while (reader.Read())
{
    JsonTokenType tokenType = reader.TokenType;
    Console.WriteLine(tokenType);
}

Výsledek

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje