Utf8JsonWriter.WriteStringValue Метод

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Перегрузки

WriteStringValue(String)	Записывает строковое текстовое значение (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(DateTime)	Записывает значение DateTime (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(DateTimeOffset)	Записывает значение DateTimeOffset (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(Guid)	Записывает значение Guid (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Записывает текстовое значение UTF-8 (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(ReadOnlySpan<Char>)	Записывает текстовое значение UTF-16 (в виде строки JSON) в качестве элемента массива JSON.
WriteStringValue(JsonEncodedText)	Записывает заранее закодированное значение (в виде строки JSON) в качестве элемента массива JSON.

WriteStringValue(String)

Исходный код:

Utf8JsonWriter.WriteValues.String.cs

Записывает строковое текстовое значение (в виде строки JSON) в качестве элемента массива JSON.

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

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Параметры

value

String

Значение, которое нужно записать в виде перекодированного в UTF-8 строкового элемента JSON массива JSON, в кодировке UTF-16.

Исключения

ArgumentException

Указанное значение слишком велико.

InvalidOperationException

Проверка включена, и операция записи приведет к получению недопустимого JSON.

Комментарии

Значение экранируется перед записью.

Если value имеет значение null, то значение NULL JSON записывается, как если бы WriteNullValue() был вызван метод .

WriteStringValue(DateTime)

Исходный код:

Utf8JsonWriter.WriteValues.DateTime.cs

Записывает значение DateTime (в виде строки JSON) в качестве элемента массива JSON.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Параметры

value

DateTime

Значение, которое нужно записать в виде строки JSON в качестве элемента массива JSON.

Исключения

InvalidOperationException

Проверка включена, и операция приведет к записи недопустимого JSON.

Комментарии

Этот метод записывает с использованием расширенного DateTime формата ISO 8601-1 (см. раздел Поддержка DateTime и DateTimeOffset в System.Text.Json); например, 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Исходный код:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

Записывает значение DateTimeOffset (в виде строки JSON) в качестве элемента массива JSON.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Параметры

value

DateTimeOffset

Значение, которое нужно записать в виде строки JSON в качестве элемента массива JSON.

Исключения

InvalidOperationException

Проверка включена, и операция приведет к записи недопустимого JSON.

Комментарии

Этот метод записывает с DateTimeOffset использованием расширенного формата ISO 8601-1 (см. раздел Поддержка DateTime и DateTimeOffset в System.Text.Json); например, 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Исходный код:

Utf8JsonWriter.WriteValues.Guid.cs

Записывает значение Guid (в виде строки JSON) в качестве элемента массива JSON.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Параметры

value

Guid

Значение, которое нужно записать в виде строки JSON в качестве элемента массива JSON.

Исключения

InvalidOperationException

Проверка включена, и операция приведет к записи недопустимого JSON.

Комментарии

Этот метод записывает Guid значение, используя значение по умолчанию StandardFormat (то есть "D"), в виде: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnn.

WriteStringValue(ReadOnlySpan<Byte>)

Исходный код:

Utf8JsonWriter.WriteValues.String.cs

Записывает текстовое значение UTF-8 (в виде строки JSON) в качестве элемента массива 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))

Параметры

utf8Value

ReadOnlySpan<Byte>

Значение, которое нужно записать в виде строкового элемента JSON массива JSON, в кодировке UTF-8.

Исключения

ArgumentException

Указанное значение слишком велико.

InvalidOperationException

Проверка включена, и операция записи приведет к получению недопустимого JSON.

Комментарии

Значение экранируется перед записью.

WriteStringValue(ReadOnlySpan<Char>)

Исходный код:

Utf8JsonWriter.WriteValues.String.cs

Записывает текстовое значение UTF-16 (в виде строки JSON) в качестве элемента массива 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))

Параметры

value

ReadOnlySpan<Char>

Значение, которое нужно записать в виде перекодированного в UTF-8 строкового элемента JSON массива JSON, в кодировке UTF-16.

Исключения

ArgumentException

Указанное значение слишком велико.

InvalidOperationException

Проверка включена, и операция записи приведет к получению недопустимого JSON.

Комментарии

Значение экранируется перед записью.

WriteStringValue(JsonEncodedText)

Исходный код:

Utf8JsonWriter.WriteValues.String.cs

Записывает заранее закодированное значение (в виде строки JSON) в качестве элемента массива 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)

Параметры

value

JsonEncodedText

Значение, которое нужно записать в виде перекодированного в UTF-8 строкового элемента JSON массива JSON, в кодировке JSON.

Исключения

InvalidOperationException

Проверка включена, и операция записи приведет к получению недопустимого JSON.

Комментарии

Значение должно быть экранировано при создании экземпляра JsonEncodedText .