Utf8JsonWriter.WriteStringValue Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v9.0.0-preview.3.24172.9

Přetížení

WriteStringValue(String)	Zapíše textovou hodnotu řetězce (jako řetězec JSON) jako prvek pole 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(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(JsonEncodedText)	Zapíše předem zakódovanou textovou hodnotu (jako řetězec JSON) jako prvek pole JSON.

WriteStringValue(String)

Zdroj:

Utf8JsonWriter.WriteValues.String.cs

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

public:
 void WriteStringValue(System::String ^ value);

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Parametry

value

String

Hodnota zakódovaná UTF-16, která se má zapsat jako element řetězce UTF-8 v poli JSON.

Výjimky

ArgumentException

Zadaná hodnota je příliš velká.

InvalidOperationException

Ověřování je povolené a operace zápisu by vygenerovala neplatný JSON.

Poznámky

Hodnota se před zápisem uteče.

Pokud value je nullhodnota , hodnota JSON null se zapíše, jako by byla WriteNullValue() volána metoda.

WriteStringValue(DateTime)

Zdroj:

Utf8JsonWriter.WriteValues.DateTime.cs

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

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Parametry

value

DateTime

Hodnota, která se má zapsat jako řetězec JSON jako prvek pole JSON.

Výjimky

InvalidOperationException

Ověření je povolené a výsledkem operace bude zápis neplatného kódu JSON.

Poznámky

Tato metoda zapisuje DateTime soubor pomocí rozšířeného formátu ISO 8601-1 (viz podpora DateTime a DateTimeOffset v System.Text.Json), například 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Zdroj:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

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

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Parametry

value

DateTimeOffset

Hodnota, která se má zapsat jako řetězec JSON jako prvek pole JSON.

Výjimky

InvalidOperationException

Ověření je povolené a výsledkem operace bude zápis neplatného kódu JSON.

Poznámky

Tato metoda zapisuje DateTimeOffset kód pomocí rozšířeného formátu ISO 8601-1 (viz Podpora dateTime a DateTimeOffset v System.Text.Json), například 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Zdroj:

Utf8JsonWriter.WriteValues.Guid.cs

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

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Parametry

value

Guid

Hodnota, která se má zapsat jako řetězec JSON jako prvek pole JSON.

Výjimky

InvalidOperationException

Ověření je povolené a výsledkem operace bude zápis neplatného kódu JSON.

Poznámky

Tato metoda zapíše Guid hodnotu pomocí výchozí StandardFormat hodnoty (tj. D) ve tvaru: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnn.

WriteStringValue(ReadOnlySpan<Byte>)

Zdroj:

Utf8JsonWriter.WriteValues.String.cs

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

public:
 void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);

public void WriteStringValue (ReadOnlySpan<byte> utf8Value);

member this.WriteStringValue : ReadOnlySpan<byte> -> unit

Public Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))

Parametry

utf8Value

ReadOnlySpan<Byte>

Hodnota kódovaná UTF-8, která se má zapsat jako element řetězce JSON pole JSON.

Výjimky

ArgumentException

Zadaná hodnota je příliš velká.

InvalidOperationException

Ověřování je povolené a operace zápisu by vygenerovala neplatný JSON.

Poznámky

Hodnota se před zápisem uteče.

WriteStringValue(ReadOnlySpan<Char>)

Zdroj:

Utf8JsonWriter.WriteValues.String.cs

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

public:
 void WriteStringValue(ReadOnlySpan<char> value);

public void WriteStringValue (ReadOnlySpan<char> value);

member this.WriteStringValue : ReadOnlySpan<char> -> unit

Public Sub WriteStringValue (value As ReadOnlySpan(Of Char))

Parametry

value

ReadOnlySpan<Char>

Hodnota zakódovaná UTF-16, která se má zapsat jako element řetězce UTF-8 v poli JSON.

Výjimky

ArgumentException

Zadaná hodnota je příliš velká.

InvalidOperationException

Ověřování je povolené a operace zápisu by vygenerovala neplatný JSON.

Poznámky

Hodnota se před zápisem uteče.

WriteStringValue(JsonEncodedText)

Zdroj:

Utf8JsonWriter.WriteValues.String.cs

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

public:
 void WriteStringValue(System::Text::Json::JsonEncodedText value);

public void WriteStringValue (System.Text.Json.JsonEncodedText value);

member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unit

Public Sub WriteStringValue (value As JsonEncodedText)

Parametry

value

JsonEncodedText

Hodnota zakódovaná ve formátu JSON, která se má zapsat jako element řetězce UTF-8 v poli JSON.

Výjimky

InvalidOperationException

Ověřování je povolené a operace zápisu by vygenerovala neplatný JSON.

Poznámky

Hodnota by již měla být řídicím znakem při vytvoření instance JsonEncodedText .