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.