Sdílet prostřednictvím


Utf8JsonWriter Třída

Definice

Poskytuje vysoce výkonné rozhraní API pro zápis textu JSON s kódováním UTF-8, které není uložené v mezipaměti.

public ref class Utf8JsonWriter sealed : IAsyncDisposable, IDisposable
public sealed class Utf8JsonWriter : IAsyncDisposable, IDisposable
type Utf8JsonWriter = class
    interface IAsyncDisposable
    interface IDisposable
type Utf8JsonWriter = class
    interface IDisposable
    interface IAsyncDisposable
Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable
Dědičnost
Utf8JsonWriter
Implementuje

Poznámky

Utf8JsonWriter text zapisuje postupně bez ukládání do mezipaměti a ve výchozím nastavení dodržuje JSON RFC, s výjimkou psaní komentářů.

Metoda, která se pokusí zapsat neplatný kód JSON, když je povolené ověření, vyvolá InvalidOperationException s kontextovou chybovou zprávou.

Pokud chcete mít možnost formátovat výstup s odsazením a prázdným místem, přeskočte ověření, NEBO pro přizpůsobení chování při úniku, vytvořte instanci JsonWriterOptions a předejte ji zapisovači.

Další informace naleznete v tématu Jak psát vlastní serializátory a deserializery pomocí system.Text.Json.

Konstruktory

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)

Inicializuje novou instanci třídy Utf8JsonWriter pomocí zadané IBufferWriter<T> k zápisu výstupu do a možnosti přizpůsobení.

Utf8JsonWriter(Stream, JsonWriterOptions)

Inicializuje novou instanci Utf8JsonWriter třídy pomocí zadaného datového proudu k zápisu výstupu a možnosti přizpůsobení.

Vlastnosti

BytesCommitted

Získá celkový počet bajtů potvrzených do výstupu aktuální instance dosud.

BytesPending

Získá počet bajtů zapsaných Utf8JsonWriter dosud, které ještě nebyly vyprázdněny na výstup a potvrzeny.

CurrentDepth

Získá hloubku aktuálního tokenu.

Options

Získá vlastní chování při zápisu JSON pomocí této instance, což označuje, zda se má formátovat výstup při zápisu, zda přeskočit strukturální ověřování JSON a které znaky se mají ukazovat.

Metody

Dispose()

Potvrdí veškerý zbývající text JSON, který ještě nebyl vyprázdněný a uvolní všechny prostředky používané aktuální instancí.

DisposeAsync()

Asynchronně potvrdí veškerý zbývající text JSON, který ještě nebyl vyprázdněn, a uvolní všechny prostředky používané aktuální instancí.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
Flush()

Potvrdí zatím napsaný text JSON, který ho zviditelní ve výstupním cíli.

FlushAsync(CancellationToken)

Asynchronně potvrdí text JSON napsaný doposud, což zviditelní výstupní cíl.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
Reset()

Obnoví interní stav této instance, aby ji bylo možné znovu použít.

Reset(IBufferWriter<Byte>)

Obnoví vnitřní stav této instance, aby ji bylo možné znovu použít s novou instancí IBufferWriter<T>.

Reset(Stream)

Obnoví vnitřní stav této instance, aby ji bylo možné znovu použít s novou instancí Stream.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)

Zapíše předkódovaný název vlastnosti a nezpracovanou hodnotu bajtů (jako řetězec JSON s kódováním Base64) jako součást dvojice název/hodnota objektu JSON.

WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Zapíše název vlastnosti a nezpracovanou hodnotu bajtů (jako řetězec JSON s kódováním Base64) jako součást dvojice název/hodnota objektu JSON.

WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Zapíše název vlastnosti a nezpracovanou hodnotu bajtů (jako řetězec JSON s kódováním Base64) jako součást dvojice název/hodnota objektu JSON.

WriteBase64String(String, ReadOnlySpan<Byte>)

Zapíše název vlastnosti a nezpracovanou hodnotu bajtů (jako řetězec JSON s kódováním Base64) jako součást dvojice název/hodnota objektu JSON.

WriteBase64StringValue(ReadOnlySpan<Byte>)

Zapíše nezpracovanou hodnotu bajtů jako řetězec JSON s kódováním Base64 jako prvek pole JSON.

WriteBoolean(JsonEncodedText, Boolean)

Zapíše předkódovaný název vlastnosti a hodnotu Boolean (jako literál JSON true nebo false) jako součást páru název/hodnota objektu JSON.

WriteBoolean(ReadOnlySpan<Byte>, Boolean)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Boolean (jako literál JSON true nebo false) jako součást dvojice název/hodnota objektu JSON.

WriteBoolean(ReadOnlySpan<Char>, Boolean)

Zapíše název vlastnosti zadaný jako rozsah znaků jen pro čtení a hodnotu Boolean (jako literál JSON true nebo false) jako součást dvojice název/hodnota objektu JSON.

WriteBoolean(String, Boolean)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Boolean (jako literál JSON true nebo false) jako součást páru název/hodnota objektu JSON.

WriteBooleanValue(Boolean)

Zapíše Boolean hodnotu (jako literál JSON true nebo false) jako prvek pole JSON.

WriteCommentValue(ReadOnlySpan<Byte>)

Zapíše textovou hodnotu UTF-8 jako komentář JSON.

WriteCommentValue(ReadOnlySpan<Char>)

Zapíše textovou hodnotu UTF-16 jako komentář JSON.

WriteCommentValue(String)

Zapíše textovou hodnotu řetězce jako komentář JSON.

WriteEndArray()

Zapíše konec pole JSON.

WriteEndObject()

Zapíše konec objektu JSON.

WriteNull(JsonEncodedText)

Zapíše předkódovaný název vlastnosti a literál JSON null jako součást dvojice název/hodnota objektu JSON.

WriteNull(ReadOnlySpan<Byte>)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a literál JSON null jako součást dvojice název/hodnota objektu JSON.

WriteNull(ReadOnlySpan<Char>)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a literál JSON null jako součást dvojice název/hodnota objektu JSON.

WriteNull(String)

Zapíše název vlastnosti zadaný jako řetězec a literál JSON null jako součást dvojice název/hodnota objektu JSON.

WriteNullValue()

Zapíše literál JSON null jako prvek pole JSON.

WriteNumber(JsonEncodedText, Decimal)

Zapíše předkódovaný název vlastnosti a Decimal hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Double)

Zapíše předkódovaný název vlastnosti a Double hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Int32)

Zapíše předkódovaný název vlastnosti a Int32 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Int64)

Zapíše předkódovaný název vlastnosti a Int64 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Single)

Zapíše předkódovaný název vlastnosti a Single hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, UInt32)

Zapíše předkódovaný název vlastnosti a UInt32 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, UInt64)

Zapíše předkódovaný název vlastnosti a UInt64 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Decimal)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Decimal (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Double)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Double (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Int32)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Int32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Int64)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Int64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Single)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu Single (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt32)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu UInt32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, UInt64)

Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a hodnotu UInt64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, Decimal)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Decimal (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, Double)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Double (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, Int32)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Int32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, Int64)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Int64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, Single)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Single (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, UInt32)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu UInt32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Char>, UInt64)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu UInt64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, Decimal)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Decimal (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, Double)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Double (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, Int32)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Int32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, Int64)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Int64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, Single)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Single (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, UInt32)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu UInt32 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(String, UInt64)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu UInt64 (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumberValue(Decimal)

Zapíše Decimal hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(Double)

Zapíše Double hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(Int32)

Zapíše Int32 hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(Int64)

Zapíše Int64 hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(Single)

Zapíše Single hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(UInt32)

Zapíše UInt32 hodnotu (jako číslo JSON) jako prvek pole JSON.

WriteNumberValue(UInt64)

Zapíše UInt64 hodnotu (jako číslo JSON) jako prvek pole JSON.

WritePropertyName(JsonEncodedText)

Zapíše předkódovaný název vlastnosti (jako řetězec JSON) jako první část dvojice název/hodnota objektu JSON.

WritePropertyName(ReadOnlySpan<Byte>)

Zapíše název vlastnosti UTF-8 (jako řetězec JSON) jako první část dvojice název/hodnota objektu JSON.

WritePropertyName(ReadOnlySpan<Char>)

Zapíše název vlastnosti (jako řetězec JSON) jako první část dvojice název/hodnota objektu JSON.

WritePropertyName(String)

Zapíše název vlastnosti (jako řetězec JSON) jako první část dvojice název/hodnota objektu JSON.

WriteRawValue(ReadOnlySequence<Byte>, Boolean)

Zapíše vstup jako obsah JSON. Očekává se, že vstupní obsah je jedna úplná hodnota JSON.

WriteRawValue(ReadOnlySpan<Byte>, Boolean)

Zapíše vstup jako obsah JSON. Očekává se, že vstupní obsah je jedna úplná hodnota JSON.

WriteRawValue(ReadOnlySpan<Char>, Boolean)

Zapíše vstup jako obsah JSON. Očekává se, že vstupní obsah je jedna úplná hodnota JSON.

WriteRawValue(String, Boolean)

Zapíše vstup jako obsah JSON. Očekává se, že vstupní obsah je jedna úplná hodnota JSON.

WriteStartArray()

Zapíše začátek pole JSON.

WriteStartArray(JsonEncodedText)

Zapíše začátek pole JSON s předkódovaným názvem vlastnosti jako klíčem.

WriteStartArray(ReadOnlySpan<Byte>)

Zapíše začátek pole JSON s názvem vlastnosti určeným jako rozsah jen pro čtení bajtů jako klíč.

WriteStartArray(ReadOnlySpan<Char>)

Zapíše začátek pole JSON s názvem vlastnosti zadaným jako znak jen pro čtení jako klíč.

WriteStartArray(String)

Zapíše začátek pole JSON s názvem vlastnosti zadaným jako řetězec jako klíč.

WriteStartObject()

Zapíše začátek objektu JSON.

WriteStartObject(JsonEncodedText)

Zapíše začátek objektu JSON s předkódovaným názvem vlastnosti jako klíčem.

WriteStartObject(ReadOnlySpan<Byte>)

Zapíše začátek objektu JSON s názvem vlastnosti zadaným jako rozsah jen pro čtení bajtů jako klíč.

WriteStartObject(ReadOnlySpan<Char>)

Zapíše začátek objektu JSON s názvem vlastnosti zadaným jako znak jen pro čtení jako klíč.

WriteStartObject(String)

Zapíše začátek objektu JSON s názvem vlastnosti zadaným jako řetězec jako klíč.

WriteString(JsonEncodedText, DateTime)

Zapíše předkódovaný název vlastnosti a hodnotu DateTime (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(JsonEncodedText, DateTimeOffset)

Zapíše předkódovaný název vlastnosti a hodnotu DateTimeOffset (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(JsonEncodedText, Guid)

Zapíše předkódovaný název vlastnosti a hodnotu Guid (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(JsonEncodedText, JsonEncodedText)

Zapíše předkódovaný název vlastnosti a předkódovanou hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Zapíše předkódovaný název vlastnosti a textovou hodnotu UTF-8 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Zapíše předkódovaný název vlastnosti a textovou hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(JsonEncodedText, String)

Zapíše předkódovaný název vlastnosti a textovou hodnotu řetězce (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, DateTime)

Zapíše název vlastnosti UTF-8 a hodnotu DateTime (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Zapíše název vlastnosti UTF-8 a hodnotu DateTimeOffset (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, Guid)

Zapíše název vlastnosti UTF-8 a hodnotu Guid (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Zapíše název vlastnosti UTF-8 a předkódovanou hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Zapíše název vlastnosti UTF-8 a textovou hodnotu UTF-8 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Zapíše název vlastnosti UTF-8 a textovou hodnotu UTF-16 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, String)

Zapíše název vlastnosti UTF-8 a textovou hodnotu řetězce (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, DateTime)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu DateTime (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu DateTimeOffset (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, Guid)

Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a hodnotu Guid (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Zapíše název vlastnosti a předkódovanou hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Zapíše název vlastnosti UTF-16 a textovou hodnotu UTF-8 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Zapíše název vlastnosti UTF-16 a textovou hodnotu UTF-16 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, String)

Zapíše název vlastnosti UTF-16 a textovou hodnotu řetězce (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(String, DateTime)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu DateTime (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(String, DateTimeOffset)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu DateTimeOffset (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(String, Guid)

Zapíše název vlastnosti zadaný jako řetězec a hodnotu Guid (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(String, JsonEncodedText)

Zapíše název vlastnosti a předkódovanou hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(String, ReadOnlySpan<Byte>)

Zapíše název vlastnosti zadaný jako řetězec a textovou hodnotu UTF-8 (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteString(String, ReadOnlySpan<Char>)

Zapíše název vlastnosti zadaný jako řetězec a textovou hodnotu UTF-16 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(String, String)

Zapíše název vlastnosti zadaný jako řetězec a textovou hodnotu řetězce (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.

WriteStringValue(DateTime)

Zapíše DateTime hodnotu (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(DateTimeOffset)

Zapíše DateTimeOffset hodnotu (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(Guid)

Zapíše Guid hodnotu (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(JsonEncodedText)

Zapíše předem zakódovanou textovou hodnotu (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(ReadOnlySpan<Byte>)

Zapíše textovou hodnotu UTF-8 (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(ReadOnlySpan<Char>)

Zapíše textovou hodnotu UTF-16 (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(String)

Zapíše textovou hodnotu řetězce (jako řetězec JSON) jako prvek pole JSON.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro