WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

JsonTokenType — JSON-Tokenart

JsonTokenType ist eine Enumeration in System.Text.Json, die ein von Utf8JsonReader erkanntes Token beschreibt. Sie unterscheidet Objekt- und Arraygrenzen, Eigenschaftsnamen und Werte. None bezeichnet den Zustand vor dem Lesen, nicht den JSON-Wert null.

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

Syntax

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

JsonTokenType in System.Text.Json beschreibt die Art eines Tokens. Utf8JsonReader.TokenType gibt die Art des zuletzt verarbeiteten Tokens an; prüfen Sie die Eigenschaft nach einem erfolgreichen Read().

StartObject und EndObject markieren die Grenzen eines Objekts; StartArray und EndArray markieren Arraygrenzen. PropertyName bezeichnet einen Eigenschaftsnamen, nicht dessen Zeichenfolgenwert: Dafür wird String verwendet. Weitere Wertarten sind Number, True, False und Null.

None ist der Anfangszustand vor dem Lesen von Daten und unterscheidet sich vom Token Null. Comment steht für einen Kommentar, erfordert jedoch JsonCommentHandling.Allow. Der Standardwert Disallow weist Kommentare zurück; Skip überspringt sie, ohne Tokens bereitzustellen.

Das Beispiel gibt zuerst None und danach die Arten der aufeinanderfolgenden Tokens aus. Die Schleife wird fortgesetzt, solange Read() true zurückgibt. Ungültiges JSON kann eine JsonException auslösen, statt die Schleife einfach zu beenden.

Beispiele

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);
}

Ergebnis

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen