Utf8JsonReader Struktura
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje vysoce výkonné rozhraní API pro přístup jen pro čtení k textu JSON s kódováním UTF-8.
public value class Utf8JsonReaderpublic ref struct Utf8JsonReadertype Utf8JsonReader = structPublic Structure Utf8JsonReader- Dědičnost
Poznámky
Utf8JsonReader zpracovává text sekvenčně bez ukládání do mezipaměti a ve výchozím nastavení dodržuje výhradně dokument RFC JSON.
Při Utf8JsonReader výskytu neplatného formátu JSON vyvolá JsonException základní informace o chybě, jako je číslo řádku a pozice bajtu na řádku.
Vzhledem k tomu, že tento typ je ref strukturou, nepodporuje přímo asynchronní. Poskytuje však podporu opětovného čtení neúplných dat a k dalšímu čtení dat.
Pokud chcete mít možnost nastavit maximální hloubku při čtení nebo povolit přeskočení komentářů, vytvořte instanci JsonReaderOptions a předejte ji čtenáři.
Další informace naleznete v tématu Použití Utf8JsonReader.
Konstruktory
| Name | Description |
|---|---|
| Utf8JsonReader(ReadOnlySequence<Byte>, Boolean, JsonReaderState) |
Inicializuje novou instanci Utf8JsonReader struktury, která zpracovává posloupnost kódování UTF-8 jen pro čtení a označuje, zda vstup obsahuje veškerý text ke zpracování. |
| Utf8JsonReader(ReadOnlySequence<Byte>, JsonReaderOptions) |
Inicializuje novou instanci Utf8JsonReader struktury, která zpracovává posloupnost kódování UTF-8 jen pro čtení pomocí zadaných možností. |
| Utf8JsonReader(ReadOnlySpan<Byte>, Boolean, JsonReaderState) |
Inicializuje novou instanci Utf8JsonReader struktury, která zpracovává rozsah kódování UTF-8 jen pro čtení a označuje, zda vstup obsahuje veškerý text ke zpracování. |
| Utf8JsonReader(ReadOnlySpan<Byte>, JsonReaderOptions) |
Inicializuje novou instanci Utf8JsonReader struktury, která zpracovává rozsah jen pro čtení kódování UTF-8 text pomocí zadaných možností. |
Vlastnosti
| Name | Description |
|---|---|
| BytesConsumed |
Získá celkový počet bajtů spotřebovaných dosud touto instancí Utf8JsonReader. |
| CurrentDepth |
Získá hloubku aktuálního tokenu. |
| CurrentState |
Získá aktuální Utf8JsonReader stav pro předání konstruktoru Utf8JsonReader s více daty. |
| HasValueSequence |
Získá hodnotu, která označuje, která |
| IsFinalBlock |
Získá hodnotu, která označuje, jestli byla všechna data JSON zadaná nebo jestli je k dispozici více dat. |
| Position |
Získá aktuální SequencePosition v zadané UTF-8 kódovaný vstup ReadOnlySequence<bajt> nebo výchozí SequencePosition , pokud Utf8JsonReader struktura byla vytvořena pomocí ReadOnlySpan<bajt>. |
| TokenStartIndex |
Získá index, na který začíná poslední zpracovaný token JSON (v rámci zadaného vstupního textu s kódováním UTF-8), přeskočí jakékoli prázdné znaky. |
| TokenType |
Získá typ posledního zpracovaného tokenu JSON v textu JSON s kódováním UTF-8. |
| ValueIsEscaped |
Získá hodnotu, která určuje, zda aktuální ValueSpan nebo ValueSequence vlastnosti obsahují řídicí sekvence na RFC 8259 oddíl 7, a proto před spotřebou vyžadovat zrušení zapouzdření. |
| ValueSequence |
Získá nezpracovanou hodnotu posledního zpracovaného tokenu jako řez bajtu> ReadOnlySequence<vstupní datové části, pouze pokud je token obsažen v několika segmentech. |
| ValueSpan |
Získá nezpracovanou hodnotu posledního zpracovaného tokenu jako řez bajtu ReadOnlySpan<vstupní datové části, pokud se token vejde do jednoho segmentu nebo pokud byl čtenář vytvořen datovou částí JSON obsaženou v bajte> ReadOnlySpan<.> |
Metody
| Name | Description |
|---|---|
| CopyString(Span<Byte>) |
Zkopíruje aktuální hodnotu tokenu JSON ze zdroje, která není neurčitá, jako bajty UTF-8 do vyrovnávací paměti. |
| CopyString(Span<Char>) |
Zkopíruje aktuální hodnotu tokenu JSON ze zdroje bez neurčení jako UTF-16 znaků do vyrovnávací paměti. |
| GetBoolean() |
Načte další hodnotu tokenu JSON ze zdroje jako hodnotu Boolean. |
| GetByte() |
Parsuje aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Byte. |
| GetBytesFromBase64() |
Analyzuje aktuální hodnotu tokenu JSON ze zdroje a dekóduje řetězec JSON kódovaný v base64 jako pole bajtů. |
| GetComment() |
Parsuje aktuální hodnotu tokenu JSON ze zdroje jako komentář a překóduje ji jako String. |
| GetDateTime() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu DateTime. |
| GetDateTimeOffset() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu DateTimeOffset. |
| GetDecimal() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Decimal. |
| GetDouble() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Double. |
| GetGuid() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Guid. |
| GetInt16() |
Parsuje aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Int16. |
| GetInt32() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Int32. |
| GetInt64() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Int64. |
| GetSByte() |
Parsuje aktuální hodnotu tokenu JSON ze zdroje jako hodnotu SByte. |
| GetSingle() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu Single. |
| GetString() |
Načte další hodnotu tokenu JSON ze zdrojového neuskutečňovaného kódu a překóduje ji jako řetězec. |
| GetUInt16() |
Parsuje aktuální hodnotu tokenu JSON ze zdroje jako hodnotu UInt16. |
| GetUInt32() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu UInt32. |
| GetUInt64() |
Načte další hodnotu tokenu JSON ze zdroje a parsuje ji do objektu UInt64. |
| Read() |
Načte další token JSON ze vstupního zdroje. |
| Skip() |
Přeskočí podřízené položky aktuálního tokenu JSON. |
| TryGetByte(Byte) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Byte a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetBytesFromBase64(Byte[]) |
Pokusí se parsovat aktuální hodnotu tokenu JSON ze zdroje a dekóduje řetězec JSON kódovaný jako pole bajtů s kódováním Base64 a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetDateTime(DateTime) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu DateTime a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetDateTimeOffset(DateTimeOffset) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu DateTimeOffset a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetDecimal(Decimal) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Decimal a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetDouble(Double) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Double a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetGuid(Guid) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Guid a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetInt16(Int16) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako Int16 hodnotu a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetInt32(Int32) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako Int32 hodnotu a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetInt64(Int64) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako Int64 hodnotu a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetSByte(SByte) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako SByte hodnotu a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetSingle(Single) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu Single a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetUInt16(UInt16) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu UInt16 a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetUInt32(UInt32) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu UInt32 a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TryGetUInt64(UInt64) |
Pokusí se analyzovat aktuální hodnotu tokenu JSON ze zdroje jako hodnotu UInt64 a vrátí hodnotu, která označuje, jestli operace proběhla úspěšně. |
| TrySkip() |
Pokusí se přeskočit podřízené položky aktuálního tokenu JSON. |
| ValueTextEquals(ReadOnlySpan<Byte>) |
Porovná kódovaný text UTF-8 v bajte jen pro čtení s hodnotou tokenu JSON bez kóty ve zdroji a vrátí hodnotu, která označuje, jestli odpovídají. |
| ValueTextEquals(ReadOnlySpan<Char>) |
Porovná text v rozsahu znaků jen pro čtení s hodnotou tokenu JSON, která je ve zdroji neuskutečněná, a vrátí hodnotu, která určuje, jestli odpovídají. |
| ValueTextEquals(String) |
Porovná text řetězce s neuskutečněnou hodnotou tokenu JSON ve zdroji a vrátí hodnotu, která určuje, jestli se shodují. |
