Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

JsonTokenType — rodzaj tokenu JSON

JsonTokenType to wyliczenie z System.Text.Json opisujące token rozpoznany przez Utf8JsonReader. Pozwala odróżnić granice obiektów i tablic, nazwy właściwości oraz wartości. None oznacza stan przed odczytem, a nie wartość JSON null.

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

Składnia

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

JsonTokenType z System.Text.Json opisuje rodzaj tokenu. Właściwość Utf8JsonReader.TokenType udostępnia rodzaj ostatnio przetworzonego tokenu; sprawdzaj ją po udanym Read().

StartObject i EndObject oznaczają granice obiektu, a StartArray i EndArray — tablicy. PropertyName oznacza nazwę właściwości, nie jej tekstową wartość: tę reprezentuje String. Pozostałe rodzaje wartości to Number, True, False i Null.

None to stan początkowy przed odczytem danych, różny od tokenu Null. Comment reprezentuje komentarz, ale wymaga JsonCommentHandling.Allow. Domyślne Disallow odrzuca komentarze; Skip pomija je bez udostępniania tokenów.

W przykładzie początkowo wypisywane jest None, a następnie rodzaje kolejnych tokenów. Pętla działa, dopóki Read() zwraca true. Niepoprawny JSON może spowodować JsonException, zamiast zwykłego zakończenia pętli.

Przykłady

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

Wynik

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła