Utf8JsonWriter Třída

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v11.0.0-preview.5.26302.115

Zdroj:

Utf8JsonWriter.cs

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 IDisposable
    interface IAsyncDisposable

Public NotInheritable Class Utf8JsonWriter
Implements IAsyncDisposable, IDisposable

Dědičnost

Object

Utf8JsonWriter

Implementuje

IAsyncDisposable IDisposable

Poznámky

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

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

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

Name	Description
Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)	Inicializuje novou instanci Utf8JsonWriter třídy pomocí zadané IBufferWriter<T> pro zápis 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

Name	Description
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é dosud 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

Name	Description
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í.
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.
Reset()	Obnoví interní stav této instance, aby ji bylo možné znovu použít.
Reset(IBufferWriter<Byte>, JsonWriterOptions)	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.
Reset(IBufferWriter<Byte>)	Obnoví vnitřní stav této instance tak, aby ji bylo možné znovu použít s novou instancí IBufferWriter<T>.
Reset(Stream, JsonWriterOptions)	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.
Reset(Stream)	Obnoví vnitřní stav této instance tak, aby ji bylo možné znovu použít s novou instancí Stream.
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.
WriteBase64StringSegment(ReadOnlySpan<Byte>, Boolean)	Zapíše vstupní bajty jako částečný řetězec JSON.
WriteBase64StringValue(ReadOnlySpan<Byte>)	Zapíše nezpracovanou hodnotu bajtů jako řetězec JSON s kódováním Base64.
WriteBoolean(JsonEncodedText, Boolean)	Zapíše předkódovaný název a Boolean hodnotu vlastnosti (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 Boolean hodnotu (jako literál JSON true nebo false) jako součást páru název/hodnota objektu JSON.
WriteBoolean(ReadOnlySpan<Char>, Boolean)	Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a Boolean hodnotu (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 Boolean hodnotu (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).
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 name/value objektu JSON.
WriteNull(ReadOnlySpan<Byte>)	Zapíše název vlastnosti určené jako rozsah jen pro čtení bajtů a literál JSON 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 páru název/hodnota objektu JSON.
WriteNull(String)	Zapíše název vlastnosti určené jako řetězec a literál JSON null jako součást dvojice name/value objektu JSON.
WriteNullValue()	Zapíše literál JSON null.
WriteNumber(JsonEncodedText, Decimal)	Zapíše předkódovaný název a Decimal hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, Double)	Zapíše předkódovaný název a Double hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, Int32)	Zapíše předkódovaný název a Int32 hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, Int64)	Zapíše předkódovaný název a Int64 hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, Single)	Zapíše předkódovaný název a Single hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, UInt32)	Zapíše předkódovaný název a UInt32 hodnotu vlastnosti (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(JsonEncodedText, UInt64)	Zapíše předkódovaný název a UInt64 hodnotu vlastnosti (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 Decimal hodnotu (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 Double hodnotu (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 Int32 hodnotu (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 Int64 hodnotu (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 Single hodnotu (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 UInt32 hodnotu (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 UInt64 hodnotu (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 Decimal hodnotu (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 Double hodnotu (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 Int32 hodnotu (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 Int64 hodnotu (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 Single hodnotu (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 UInt32 hodnotu (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 UInt64 hodnotu (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 Decimal hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, Double)	Zapíše název vlastnosti zadaný jako řetězec a Double hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, Int32)	Zapíše název vlastnosti zadaný jako řetězec a Int32 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, Int64)	Zapíše název vlastnosti zadaný jako řetězec a Int64 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, Single)	Zapíše název vlastnosti zadaný jako řetězec a Single hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, UInt32)	Zapíše název vlastnosti zadaný jako řetězec a UInt32 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumber(String, UInt64)	Zapíše název vlastnosti zadaný jako řetězec a UInt64 hodnotu (jako číslo JSON) jako součást páru název/hodnota objektu JSON.
WriteNumberValue(Decimal)	Zapíše Decimal hodnotu (jako číslo JSON).
WriteNumberValue(Double)	Zapíše Double hodnotu (jako číslo JSON).
WriteNumberValue(Int32)	Zapíše Int32 hodnotu (jako číslo JSON).
WriteNumberValue(Int64)	Zapíše Int64 hodnotu (jako číslo JSON).
WriteNumberValue(Single)	Zapíše Single hodnotu (jako číslo JSON).
WriteNumberValue(UInt32)	Zapíše UInt32 hodnotu (jako číslo JSON).
WriteNumberValue(UInt64)	Zapíše UInt64 hodnotu (jako číslo 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 a DateTime hodnotu vlastnosti (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Zapíše předkódovaný název a DateTimeOffset hodnotu vlastnosti (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(JsonEncodedText, Guid)	Zapíše předkódovaný název a Guid hodnotu vlastnosti (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 DateTime hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Zapíše název vlastnosti UTF-8 a DateTimeOffset hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(ReadOnlySpan<Byte>, Guid)	Zapíše název vlastnosti UTF-8 a Guid hodnotu (jako řetězec JSON) jako součást páru 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 DateTime hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a DateTimeOffset hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(ReadOnlySpan<Char>, Guid)	Zapíše název vlastnosti určené jako rozsah znaků jen pro čtení a Guid hodnotu (jako řetězec JSON) jako součást páru 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 DateTime hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(String, DateTimeOffset)	Zapíše název vlastnosti zadaný jako řetězec a DateTimeOffset hodnotu (jako řetězec JSON) jako součást páru název/hodnota objektu JSON.
WriteString(String, Guid)	Zapíše název vlastnosti zadaný jako řetězec a Guid hodnotu (jako řetězec JSON) jako součást páru 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).
WriteStringValue(DateTimeOffset)	Zapíše DateTimeOffset hodnotu (jako řetězec JSON).
WriteStringValue(Guid)	Zapíše Guid hodnotu (jako řetězec JSON).
WriteStringValue(JsonEncodedText)	Zapíše předkódovanou textovou hodnotu (jako řetězec JSON).
WriteStringValue(ReadOnlySpan<Byte>)	Zapíše textovou hodnotu UTF-8 (jako řetězec JSON).
WriteStringValue(ReadOnlySpan<Char>)	Zapíše textovou hodnotu UTF-16 (jako řetězec JSON).
WriteStringValue(String)	Zapíše textovou hodnotu řetězce (jako řetězec JSON).
WriteStringValueSegment(ReadOnlySpan<Byte>, Boolean)	Zapíše segment textové hodnoty UTF-8 jako částečný řetězec JSON.
WriteStringValueSegment(ReadOnlySpan<Char>, Boolean)	Zapíše segment textové hodnoty jako částečný řetězec JSON.