Utf8JsonWriter.WriteStringValue Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

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

Przeciążenia

WriteStringValue(String)	Zapisuje wartość tekstową ciągu (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(DateTime)	DateTime Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(DateTimeOffset)	DateTimeOffset Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(Guid)	Guid Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Zapisuje wartość tekstową UTF-8 (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(ReadOnlySpan<Char>)	Zapisuje wartość tekstową UTF-16 (jako ciąg JSON) jako element tablicy JSON.
WriteStringValue(JsonEncodedText)	Zapisuje wstępnie zakodowaną wartość tekstową (jako ciąg JSON) jako element tablicy JSON.

WriteStringValue(String)

Źródło:

Utf8JsonWriter.WriteValues.String.cs

Zapisuje wartość tekstową ciągu (jako ciąg JSON) jako element tablicy 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

Zakodowana w formacie UTF-16 wartość, która ma być zapisywana jako transkodowany element ciągu JSON utF-8 tablicy JSON.

Wyjątki

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

Uwagi

Wartość zostanie uniknięta przed zapisem.

Jeśli value jest to null, wartość null JSON jest zapisywana, tak jakby WriteNullValue() metoda została wywołana.

WriteStringValue(DateTime)

Źródło:

Utf8JsonWriter.WriteValues.DateTime.cs

DateTime Zapisuje wartość (jako ciąg JSON) jako element tablicy 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

Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.

Wyjątki

InvalidOperationException

Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.

Uwagi

Ta metoda zapisuje DateTime format rozszerzony ISO 8601-1 (zobacz obsługę dateTime i DateTimeOffset w pliku System.Text.Json); na przykład 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Źródło:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

DateTimeOffset Zapisuje wartość (jako ciąg JSON) jako element tablicy 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

Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.

Wyjątki

InvalidOperationException

Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.

Uwagi

Ta metoda zapisuje DateTimeOffset format rozszerzony ISO 8601-1 (zobacz obsługa typu DateTime i DateTimeOffset w pliku System.Text.Json); na przykład 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Źródło:

Utf8JsonWriter.WriteValues.Guid.cs

Guid Zapisuje wartość (jako ciąg JSON) jako element tablicy 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

Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.

Wyjątki

InvalidOperationException

Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.

Uwagi

Ta metoda zapisuje Guid wartość przy użyciu wartości domyślnej StandardFormat (czyli "D") jako formularza: nnnnnn-nnnn-nnnn-nn.

WriteStringValue(ReadOnlySpan<Byte>)

Źródło:

Utf8JsonWriter.WriteValues.String.cs

Zapisuje wartość tekstową UTF-8 (jako ciąg JSON) jako element tablicy 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>

Zakodowana w formacie UTF-8 wartość do zapisania jako element ciągu JSON tablicy JSON.

Wyjątki

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

Uwagi

Wartość zostanie uniknięta przed zapisem.

WriteStringValue(ReadOnlySpan<Char>)

Źródło:

Utf8JsonWriter.WriteValues.String.cs

Zapisuje wartość tekstową UTF-16 (jako ciąg JSON) jako element tablicy 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>

Zakodowana w formacie UTF-16 wartość, która ma być zapisywana jako transkodowany element ciągu JSON utF-8 tablicy JSON.

Wyjątki

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

Uwagi

Wartość zostanie uniknięta przed zapisem.

WriteStringValue(JsonEncodedText)

Źródło:

Utf8JsonWriter.WriteValues.String.cs

Zapisuje wstępnie zakodowaną wartość tekstową (jako ciąg JSON) jako element tablicy 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

Zakodowana w formacie JSON wartość do zapisania jako transkodowany element ciągu JSON w formacie UTF-8 tablicy JSON.

Wyjątki

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

Uwagi

Wartość powinna zostać już uniknięta po utworzeniu JsonEncodedText wystąpienia.