KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

JsonTokenType — JSON-tokensoort

JsonTokenType is een enumeratie in System.Text.Json die een door Utf8JsonReader herkend token beschrijft. De enumeratie maakt onderscheid tussen grenzen van objecten en arrays, eigenschapsnamen en waarden. None is de toestand vóór het lezen, niet de JSON-waarde null.

Versie: .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 beschrijft de soort van een token. Utf8JsonReader.TokenType geeft de soort van het laatst verwerkte token weer; controleer deze eigenschap nadat Read() is geslaagd.

StartObject en EndObject markeren de grenzen van een object; StartArray en EndArray markeren die van een array. PropertyName duidt een eigenschapsnaam aan, niet de tekenreekswaarde ervan: daarvoor wordt String gebruikt. Andere waardesoorten zijn Number, True, False en Null.

None is de begintoestand voordat gegevens worden gelezen en verschilt van het token Null. Comment staat voor een opmerking, maar vereist JsonCommentHandling.Allow. De standaardwaarde, Disallow, weigert opmerkingen; Skip slaat ze over zonder tokens beschikbaar te stellen.

Het voorbeeld geeft eerst None weer en daarna de soorten van opeenvolgende tokens. De lus gaat door zolang Read() true retourneert. Ongeldige JSON kan een JsonException veroorzaken in plaats van de lus gewoon te beëindigen.

Voorbeelden

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

Resultaat

None
StartObject
PropertyName
String
PropertyName
True
PropertyName
Null
EndObject

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen