Utf8JsonWriter.WriteString 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í

WriteString(JsonEncodedText, JsonEncodedText)	Zapíše předkódovaný název vlastnosti a předem zakódovanou hodnotu (jako řetězec JSON) jako součást dvojice 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 dvojice název/hodnota objektu JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Zapíše předem zakódovaný název vlastnosti a textovou hodnotu (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Zapíše předem zakódovaný název vlastnosti a textovou hodnotu UTF-8 (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.
WriteString(JsonEncodedText, Guid)	Zapíše název a Guid hodnotu předem zakódované vlastnosti (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Zapíše název a DateTimeOffset hodnotu předem zakódované vlastnosti (jako řetězec JSON) jako součást dvojice název/hodnota objektu JSON.
WriteString(JsonEncodedText, DateTime)	Zapíše název a DateTime hodnotu předem zakódované vlastnosti (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, String)	Zapíše název vlastnosti zadaný jako řetězec a řetězcovou textovou hodnotu (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, 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, 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, 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, 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(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(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<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<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<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<Char>, DateTime)	Zapíše název vlastnosti zadaný jako znakový rozsah 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 znakový rozsah 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 znakový rozsah jen pro čtení a Guid 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<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(JsonEncodedText, JsonEncodedText)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

JsonEncodedText

Hodnota zakódovaná ve formátu JSON, která se má zapsat jako řetězec JSON s kódováním UTF-8 jako součást páru název/hodnota.

Výjimky

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota by již měly být řídicím znakem při vytvoření instance objektu JsonEncodedText .

WriteString(JsonEncodedText, String)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);

member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

String

Hodnota, která se má zapsat jako řetězec JSON s kódováním UTF-8 v rámci páru název/hodnota.

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

Název vlastnosti by již měl být řídicím znakem při vytvoření instance JsonEncodedText .

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

ReadOnlySpan<Char>

Hodnota, která se má zapsat jako řetězec JSON s kódováním UTF-8 v rámci páru název/hodnota.

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

Název vlastnosti by již měl být řídicím znakem při vytvoření instance JsonEncodedText .

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

utf8Value

ReadOnlySpan<Byte>

Hodnota zakódovaná UTF-8, která se má zapisovat jako řetězec JSON jako součást páru název/hodnota.

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

Název vlastnosti by již měl být řídicím znakem při vytvoření instance JsonEncodedText .

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

WriteString(JsonEncodedText, Guid)

Zdroj:

Utf8JsonWriter.WriteProperties.Guid.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);

member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

Guid

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

InvalidOperationException

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

Poznámky

Zapíše Guid pomocí výchozí StandardFormat hodnoty (tj. D) ve tvaru: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn.

Název vlastnosti by již měl být řídicím znakem při vytvoření instance JsonEncodedText .

WriteString(JsonEncodedText, DateTimeOffset)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTimeOffset

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

InvalidOperationException

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

Poznámky

DateTimeOffset Zapíše 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-07:00.

Název vlastnosti by již měl být řídicím znakem při vytvoření instance JsonEncodedText .

WriteString(JsonEncodedText, DateTime)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTime.cs

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.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

Parametry

propertyName

JsonEncodedText

Název vlastnosti zakódované ve formátu JSON objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTime

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

InvalidOperationException

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

Poznámky

Zapíše DateTime objekt 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.

Název vlastnosti by již měl být při vytvoření instance objektu JsonEncodedText řídicí znak.

WriteString(String, JsonEncodedText)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

Parametry

propertyName

String

Název vlastnosti objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

JsonEncodedText

Hodnota zakódovaná ve formátu JSON, která se má zapsat jako řetězec JSON s kódováním UTF-8 v rámci páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

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

Název vlastnosti je před zápisem u řídicího znaku.

WriteString(String, String)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

member this.WriteString : string * string -> unit

Public Sub WriteString (propertyName As String, value As String)

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

String

Hodnota zakódovaná UTF-16, která se zapíše jako řetězec JSON s kódováním UTF-8 jako součást dvojice název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

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

WriteString(String, ReadOnlySpan<Char>)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);

public void WriteString (string propertyName, ReadOnlySpan<char> value);

member this.WriteString : string * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

ReadOnlySpan<Char>

Hodnota zakódovaná UTF-16, která se zapíše jako řetězec JSON s kódováním UTF-8 jako součást dvojice název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

WriteString(String, ReadOnlySpan<Byte>)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : string * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

utf8Value

ReadOnlySpan<Byte>

Hodnota kódovaná UTF-8, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

WriteString(String, DateTimeOffset)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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.

public:
 void WriteString(System::String ^ propertyName, DateTimeOffset value);

public void WriteString (string propertyName, DateTimeOffset value);

member this.WriteString : string * DateTimeOffset -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTimeOffset

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

DateTimeOffset Zapíše 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.

Název vlastnosti je před zápisem u řídicího znaku.

WriteString(String, DateTime)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTime.cs

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.

public:
 void WriteString(System::String ^ propertyName, DateTime value);

public void WriteString (string propertyName, DateTime value);

member this.WriteString : string * DateTime -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTime

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

Zapíše DateTime objekt 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.

Název vlastnosti je před zápisem u řídicího znaku.

WriteString(String, Guid)

Zdroj:

Utf8JsonWriter.WriteProperties.Guid.cs

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.

public:
 void WriteString(System::String ^ propertyName, Guid value);

public void WriteString (string propertyName, Guid value);

member this.WriteString : string * Guid -> unit

Public Sub WriteString (propertyName As String, value As Guid)

Parametry

propertyName

String

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

Guid

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

ArgumentNullException

Parametr propertyName je null.

Poznámky

Zapíše Guid pomocí výchozí StandardFormat hodnoty (tj. D) ve formátu: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnn. Název vlastnosti je před zápisem u řídicího znaku.

WriteString(ReadOnlySpan<Char>, String)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<char> propertyName, string? value);

member this.WriteString : ReadOnlySpan<char> * string -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

String

Hodnota zakódovaná UTF-16, která se zapíše jako řetězec JSON s kódováním UTF-8 jako součást dvojice název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

Pokud value je null, hodnota JSON null se zapíše, jako by byla WriteNull(ReadOnlySpan<Char>) volána metoda .

WriteString(ReadOnlySpan<Byte>, DateTime)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);

member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódované UTF-8 objektu JSON, který se má zapsat.

value

DateTime

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

Zapíše DateTime objekt 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.

Název vlastnosti je před zápisem u řídicího znaku.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódované UTF-8 objektu JSON, který se má zapsat.

value

DateTimeOffset

Hodnota, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

DateTimeOffset Zapíše 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.

Název vlastnosti je před zápisem u řídicího znaku.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

JsonEncodedText

Hodnota zakódovaná ve formátu JSON, která se má zapsat jako řetězec JSON s kódováním UTF-8 v rámci páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

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

Název vlastnosti je před zápisem u řídicího znaku.

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

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódované UTF-8 objektu JSON, který se má zapsat.

utf8Value

ReadOnlySpan<Byte>

Hodnota kódovaná UTF-8, která se zapíše jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

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

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódované UTF-8 objektu JSON, který se má zapsat.

value

ReadOnlySpan<Char>

Hodnota zakódovaná UTF-16, která se zapíše jako řetězec JSON s kódováním UTF-8 jako součást dvojice název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota jsou před zápisem unikovány.

WriteString(ReadOnlySpan<Byte>, String)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);

member this.WriteString : ReadOnlySpan<byte> * string -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódování UTF-8 objektu JSON, který se má zapsat.

value

String

Hodnota kódovaná UTF-16, která má být zapsána jako řetězec UTF-8 překódovaný jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota jsou příliš velké.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota se před zápisem uteče.

Pokud value je nullhodnota , hodnota JSON null se zapíše, jako by byla WriteNull(ReadOnlySpan<Byte>) volána metoda.

WriteString(ReadOnlySpan<Byte>, Guid)

Zdroj:

Utf8JsonWriter.WriteProperties.Guid.cs

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

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);

member this.WriteString : ReadOnlySpan<byte> * Guid -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódování UTF-8 objektu JSON, který se má zapsat.

value

Guid

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

Zapíše Guid pomocí výchozí StandardFormat hodnoty (tj. D) ve tvaru: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn. Název vlastnosti se před zápisem uteče.

WriteString(ReadOnlySpan<Char>, DateTime)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTime value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);

member this.WriteString : ReadOnlySpan<char> * DateTime -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTime

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

DateTime Zapíše 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.

Název vlastnosti se před zápisem uteče.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Zdroj:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

DateTimeOffset

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

DateTimeOffset Zapíše 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-07:00.

Název vlastnosti se před zápisem uteče.

WriteString(ReadOnlySpan<Char>, Guid)

Zdroj:

Utf8JsonWriter.WriteProperties.Guid.cs

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

public:
 void WriteString(ReadOnlySpan<char> propertyName, Guid value);

public void WriteString (ReadOnlySpan<char> propertyName, Guid value);

member this.WriteString : ReadOnlySpan<char> * Guid -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

Guid

Hodnota, která se má zapsat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

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

Poznámky

Zapíše Guid pomocí výchozí StandardFormat hodnoty (tj. D) ve tvaru: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn. Název vlastnosti se před zápisem uteče.

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

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

utf8Value

ReadOnlySpan<Byte>

Hodnota zakódovaná UTF-8, která se má zapisovat jako řetězec JSON jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota je příliš velká.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota se před zápisem uteče.

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

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

Parametry

propertyName

ReadOnlySpan<Char>

Název vlastnosti kódované UTF-16 objektu JSON, který se má překódovat a zapsat jako UTF-8.

value

ReadOnlySpan<Char>

Hodnota kódovaná UTF-16, která má být zapsána jako řetězec UTF-8 překódovaný jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti nebo hodnota je příliš velká.

InvalidOperationException

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

Poznámky

Název vlastnosti a hodnota se před zápisem uteče.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Zdroj:

Utf8JsonWriter.WriteProperties.String.cs

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.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

Parametry

utf8PropertyName

ReadOnlySpan<Byte>

Název vlastnosti kódování UTF-8 objektu JSON, který se má zapsat.

value

JsonEncodedText

Hodnota zakódovaná ve formátu JSON, která se má zapsat jako řetězec JSON s kódováním UTF-8 jako součást páru název/hodnota.

Výjimky

ArgumentException

Zadaný název vlastnosti je příliš velký.

InvalidOperationException

Ověřování je povolené a výsledkem této metody je zápis neplatného kódu JSON.

Poznámky

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

Název vlastnosti se před zápisem uteče.