Utf8JsonWriter.WriteStringValue Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Name | Description |
|---|---|
| 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(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). |
| WriteStringValue(JsonEncodedText) |
Zapíše předkódovanou textovou hodnotu (jako řetězec JSON). |
WriteStringValue(DateTime)
Zapíše DateTime hodnotu (jako řetězec 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.
Výjimky
Je povolené ověření a operace by způsobovala zápis neplatný json.
Poznámky
Tato metoda zapíše DateTime použití 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.
Platí pro
WriteStringValue(DateTimeOffset)
Zapíše DateTimeOffset hodnotu (jako řetězec 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.
Výjimky
Je povolené ověření a operace by způsobovala zápis neplatný json.
Poznámky
Tato metoda zapíše DateTimeOffset použití 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.
Platí pro
WriteStringValue(Guid)
Zapíše Guid hodnotu (jako řetězec 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.
Výjimky
Je povolené ověření a operace by způsobovala zápis neplatný json.
Poznámky
Tato metoda zapíše Guid hodnotu pomocí výchozí StandardFormat hodnoty (tj. D), jako tvar: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnn.
Platí pro
WriteStringValue(ReadOnlySpan<Byte>)
Zapíše textovou hodnotu UTF-8 (jako řetězec 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>
Zakódovaná hodnota UTF-8, která se má zapsat jako řetězec JSON.
Výjimky
Zadaná hodnota je příliš velká.
Ověřování je povolené a operace zápisu by generovala neplatný kód JSON.
Poznámky
Hodnota je před zápisem uchycená.
Platí pro
WriteStringValue(ReadOnlySpan<Char>)
Zapíše textovou hodnotu UTF-16 (jako řetězec 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>
Zakódovaná hodnota UTF-16, která se má zapsat jako transkódovaný řetězec JSON UTF-8.
Výjimky
Zadaná hodnota je příliš velká.
Ověřování je povolené a operace zápisu by generovala neplatný kód JSON.
Poznámky
Hodnota je před zápisem uchycená.
Platí pro
WriteStringValue(String)
Zapíše textovou hodnotu řetězce (jako řetězec JSON).
public:
void WriteStringValue(System::String ^ value);
public void WriteStringValue(string? value);
public void WriteStringValue(string value);
member this.WriteStringValue : string -> unit
Public Sub WriteStringValue (value As String)
Parametry
- value
- String
Zakódovaná hodnota UTF-16, která se má zapsat jako transkódovaný řetězec JSON UTF-8.
Výjimky
Zadaná hodnota je příliš velká.
Ověřování je povolené a operace zápisu by generovala neplatný kód JSON.
Poznámky
Hodnota je před zápisem uchycená.
Pokud value ano null, hodnota JSON null je zapsána, jako by WriteNullValue() metoda byla volána.
Platí pro
WriteStringValue(JsonEncodedText)
Zapíše předkódovanou textovou hodnotu (jako řetězec 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
Zakódovaná hodnota JSON, která se má zapsat jako transkódovaný řetězec JSON UTF-8.
Výjimky
Ověřování je povolené a operace zápisu by generovala neplatný kód JSON.
Poznámky
Hodnota by již měla být řídicím znakem při vytvoření instance JsonEncodedText .