Utf8JsonWriter Třída

Definice

Poskytuje vysoce výkonné rozhraní API pro dopředné zápisy 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 zapíše text 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ý JSON, když je povolené ověření, vyvolá InvalidOperationException chybovou zprávu s konkrétním kontextem.

Chcete-li formátovat výstup s odsazením a prázdnými znaky, přeskočit ověřování, NEBO přizpůsobit chování uvozování, vytvořte instanci objektu JsonWriterOptions a předejte ji zapisovači.

Další informace najdete v tématu Jak psát vlastní serializátory a deserializéry pomocí System.Text.Json.

Konstruktory

Utf8JsonWriter(IBufferWriter<Byte>, JsonWriterOptions)

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

Utf8JsonWriter(Stream, JsonWriterOptions)

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

Vlastnosti

BytesCommitted

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

BytesPending

Získá počet bajtů, které Utf8JsonWriter dosud nebyly vyprázdněny do výstupu 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, jestli se má při psaní formátovat výstup, jestli se má přeskočit strukturální ověřování JSON a jaké 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čí, zda se zadaný objekt rovná aktuálnímu objektu.

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

Potvrdí text JSON, který byl dosud napsaný, a zviditelní ho v cíli výstupu.

FlushAsync(CancellationToken)

Asynchronně potvrdí dosud napsaný text JSON, což ho zviditelní pro cíl výstupu.

GetHashCode()

Slouží jako výchozí hashovací funkce.

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

Získá aktuální Type instanci.

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

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

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

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

Reset(IBufferWriter<Byte>)

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

Reset(Stream)

Resetuje interní 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ředem zakódovaný název vlastnosti a hodnotu nezpracovaných 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 název a Boolean hodnotu předem zakódované vlastnosti (jako literál JSON true nebo false) jako součást dvojice název/hodnota objektu JSON.

WriteBoolean(ReadOnlySpan<Byte>, Boolean)

Zapíše název vlastnosti zadaný jako rozsah bajtů jen pro čtení a Boolean hodnotu (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 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 dvojice 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ředem zakódovaný název vlastnosti a hodnotu null literálu JSON jako součást dvojice název/hodnota objektu JSON.

WriteNull(ReadOnlySpan<Byte>)

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

WriteNull(ReadOnlySpan<Char>)

Zapíše název vlastnosti zadaný 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 název a Decimal hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Double)

Zapíše název a Double hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Int32)

Zapíše název a Int32 hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Int64)

Zapíše název a Int64 hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, Single)

Zapíše název a Single hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, UInt32)

Zapíše název a UInt32 hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(JsonEncodedText, UInt64)

Zapíše název a UInt64 hodnotu předem zakódované vlastnosti (jako číslo JSON) jako součást dvojice název/hodnota objektu JSON.

WriteNumber(ReadOnlySpan<Byte>, Decimal)

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

WriteNumber(ReadOnlySpan<Byte>, Double)

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

WriteNumber(ReadOnlySpan<Byte>, Int32)

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

WriteNumber(ReadOnlySpan<Byte>, Int64)

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

WriteNumber(ReadOnlySpan<Byte>, Single)

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

WriteNumber(ReadOnlySpan<Byte>, UInt32)

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

WriteNumber(ReadOnlySpan<Byte>, UInt64)

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

WriteNumber(ReadOnlySpan<Char>, Decimal)

Zapíše název vlastnosti zadaný 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 zadaný 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 zadaný 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 zadaný 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 zadaný 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 zadaný 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 zadaný 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 dvojice 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 dvojice 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 dvojice 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 dvojice 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 dvojice 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 dvojice 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 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ředem zakó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 zadaným jako rozsah bajtů jen pro čtení jako klíč.

WriteStartArray(ReadOnlySpan<Char>)

Zapíše začátek pole JSON s názvem vlastnosti zadaným jako znakový rozsah 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 bajtů jen pro čtení jako klíč.

WriteStartObject(ReadOnlySpan<Char>)

Zapíše začátek objektu JSON s názvem vlastnosti zadaným jako znakový rozsah 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ředem zakódovaný název vlastnosti a DateTime hodnotu (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.

WriteString(JsonEncodedText, DateTimeOffset)

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

WriteString(JsonEncodedText, Guid)

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

WriteString(JsonEncodedText, JsonEncodedText)

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Zapíše název předkódované 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 dvojice název/hodnota objektu JSON.

WriteString(JsonEncodedText, String)

Zapíše předem zakódovaný název vlastnosti a textovou hodnotu řetězce (jako řetězec JSON) jako součást dvojice 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 dvojice 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 dvojice 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 dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Zapíše název vlastnosti UTF-8 a předem zakódovanou hodnotu (jako řetězec JSON) jako součást dvojice 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 dvojice název/hodnota objektu JSON.

WriteString(ReadOnlySpan<Char>, DateTime)

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

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

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

WriteString(ReadOnlySpan<Char>, Guid)

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

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Zapíše název vlastnosti a předem zakódovanou hodnotu (jako řetězec JSON) jako součást dvojice 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 dvojice 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 dvojice 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 dvojice 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 dvojice název/hodnota objektu JSON.

WriteString(String, JsonEncodedText)

Zapíše název vlastnosti a předem zakódovanou hodnotu (jako řetězec JSON) jako součást dvojice 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 dvojice 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 dvojice 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 se provádí funkce awaits u úloh vrácených z asynchronního jednorázového režimu.

Platí pro