Utf8JsonReader Struct-datatyp
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller ett högpresterande API för vidarebefordrad, skrivskyddad åtkomst till UTF-8-kodad JSON-text.
public value class Utf8JsonReaderpublic ref struct Utf8JsonReadertype Utf8JsonReader = structPublic Structure Utf8JsonReader- Arv
Kommentarer
Utf8JsonReader bearbetar texten sekventiellt utan cachelagring och följer som standard strikt JSON RFC.
När Utf8JsonReader det uppstår ogiltig JSON genereras en JsonException med grundläggande felinformation som radnummer och byteposition på raden.
Eftersom den här typen är en referens-struct har den inte direkt stöd för asynkronisering. Det ger dock stöd för återaktivering för att läsa ofullständiga data och fortsätta läsa när fler data visas.
För att kunna ange maximalt djup vid läsning eller tillåta överhoppning av kommentarer skapar du en instans av JsonReaderOptions och skickar den till läsaren.
Mer information finns i Använda Utf8JsonReader.
Konstruktorer
| Name | Description |
|---|---|
| Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) |
Initierar en ny instans av Utf8JsonReader strukturen som bearbetar en skrivskyddad sekvens med UTF-8-kodad text och anger om indata innehåller all text som ska bearbetas. |
| Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) |
Initierar en ny instans av Utf8JsonReader strukturen som bearbetar en skrivskyddad sekvens med UTF-8-kodad text med de angivna alternativen. |
| Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState) |
Initierar en ny instans av Utf8JsonReader strukturen som bearbetar ett skrivskyddat intervall med UTF-8-kodad text och anger om indata innehåller all text som ska bearbetas. |
| Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions) |
Initierar en ny instans av Utf8JsonReader strukturen som bearbetar ett skrivskyddat intervall med UTF-8-kodad text med de angivna alternativen. |
Egenskaper
| Name | Description |
|---|---|
| BytesConsumed |
Hämtar det totala antalet byte som förbrukats hittills av den här instansen Utf8JsonReaderav . |
| CurrentDepth |
Hämtar djupet för den aktuella token. |
| CurrentState |
Hämtar det aktuella Utf8JsonReader tillståndet för att skicka till en Utf8JsonReader konstruktor med mer data. |
| HasValueSequence |
Hämtar ett värde som anger vilken egenskap som |
| IsFinalBlock |
Hämtar ett värde som anger om alla JSON-data har angetts eller om det kommer mer data. |
| Position |
Hämtar strömmen SequencePosition inom den angivna UTF-8-kodade indatan ReadOnlySequence<byte> eller ett standardvärde SequencePosition om structen Utf8JsonReader skapades med en ReadOnlySpan-byte<>. |
| TokenStartIndex |
Hämtar indexet som den senast bearbetade JSON-token börjar på (inom den angivna UTF-8-kodade indatatexten) och hoppar över allt tomt utrymme. |
| TokenType |
Hämtar typen av den senast bearbetade JSON-token i UTF-8-kodad JSON-text. |
| ValueIsEscaped |
Hämtar ett värde som anger om de aktuella ValueSpan egenskaperna eller ValueSequence egenskaperna innehåller escape-sekvenser per RFC 8259 avsnitt 7 och därför kräver avkapning innan de förbrukas. |
| ValueSequence |
Hämtar råvärdet för den senast bearbetade token som en ReadOnlySequence<byte-sektor> i indatanyttolasten, endast om token finns i flera segment. |
| ValueSpan |
Hämtar råvärdet för den senast bearbetade token som en ReadOnlySpan<byte-sektor> i indatanyttolasten, om token passar i ett enda segment eller om läsaren har konstruerats med en JSON-nyttolast som finns i en ReadOnlySpan-byte<>. |
Metoder
| Name | Description |
|---|---|
| CopyString(Span<Byte>) |
Kopierar det aktuella JSON-tokenvärdet från källan, ej kapslade, som UTF-8 byte till en buffert. |
| CopyString(Span<Char>) |
Kopierar det aktuella JSON-tokenvärdet från källan, ej kapslade, som UTF-16 tecken till en buffert. |
| GetBoolean() |
Läser nästa JSON-tokenvärde från källan som en Boolean. |
| GetByte() |
Parsar det aktuella JSON-tokenvärdet från källan som en Byte. |
| GetBytesFromBase64() |
Parsar det aktuella JSON-tokenvärdet från källan och avkodar den Base64-kodade JSON-strängen som en bytematris. |
| GetComment() |
Parsar det aktuella JSON-tokenvärdet från källan som en kommentar och transkodar det som en String. |
| GetDateTime() |
Läser nästa JSON-tokenvärde från källan och parsar det till en DateTime. |
| GetDateTimeOffset() |
Läser nästa JSON-tokenvärde från källan och parsar det till en DateTimeOffset. |
| GetDecimal() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Decimal. |
| GetDouble() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Double. |
| GetGuid() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Guid. |
| GetInt16() |
Parsar det aktuella JSON-tokenvärdet från källan som en Int16. |
| GetInt32() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Int32. |
| GetInt64() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Int64. |
| GetSByte() |
Parsar det aktuella JSON-tokenvärdet från källan som en SByte. |
| GetSingle() |
Läser nästa JSON-tokenvärde från källan och parsar det till en Single. |
| GetString() |
Läser nästa JSON-tokenvärde från källan som inte är kapslade och omkodar det som en sträng. |
| GetUInt16() |
Parsar det aktuella JSON-tokenvärdet från källan som en UInt16. |
| GetUInt32() |
Läser nästa JSON-tokenvärde från källan och parsar det till en UInt32. |
| GetUInt64() |
Läser nästa JSON-tokenvärde från källan och parsar det till en UInt64. |
| Read() |
Läser nästa JSON-token från indatakällan. |
| Skip() |
Hoppar över underordnade till den aktuella JSON-token. |
| TryGetByte(Byte) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en Byte och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetBytesFromBase64(Byte[]) |
Försöker parsa det aktuella JSON-tokenvärdet från källan och avkodar den Base64-kodade JSON-strängen som en bytematris och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetDateTime(DateTime) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en DateTime och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetDateTimeOffset(DateTimeOffset) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en DateTimeOffset och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetDecimal(Decimal) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en Decimal och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetDouble(Double) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en Double och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetGuid(Guid) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en Guid och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetInt16(Int16) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som ett Int16 och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetInt32(Int32) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som ett Int32 och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetInt64(Int64) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som ett Int64 och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetSByte(SByte) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som ett SByte och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetSingle(Single) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en Single och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetUInt16(UInt16) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en UInt16 och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetUInt32(UInt32) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en UInt32 och returnerar ett värde som anger om åtgärden lyckades. |
| TryGetUInt64(UInt64) |
Försöker parsa det aktuella JSON-tokenvärdet från källan som en UInt64 och returnerar ett värde som anger om åtgärden lyckades. |
| TrySkip() |
Försöker hoppa över underordnade till den aktuella JSON-token. |
| ValueTextEquals(ReadOnlySpan<Byte>) |
Jämför UTF-8-kodad text i ett skrivskyddat byteintervall med det ej kapslade JSON-tokenvärdet i källan och returnerar ett värde som anger om de matchar. |
| ValueTextEquals(ReadOnlySpan<Char>) |
Jämför texten i ett skrivskyddat teckenintervall med det ej kapslade JSON-tokenvärdet i källan och returnerar ett värde som anger om de matchar. |
| ValueTextEquals(String) |
Jämför strängtexten med det ej kapslade JSON-tokenvärdet i källan och returnerar ett värde som anger om de matchar. |
