Utf8JsonWriter.WriteStringValue Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

System.Text.Json v11.0.0-preview.4.26230.115

Перегрузки

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

WriteStringValue(DateTime)

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

Utf8JsonWriter.WriteValues.DateTime.cs

Записывает DateTime значение (в виде строки 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.

Исключения

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).

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue(DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Параметры

value

DateTimeOffset

Значение, записываемое в виде строки JSON.

Исключения

InvalidOperationException

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

Комментарии

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

WriteStringValue(Guid)

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

Utf8JsonWriter.WriteValues.Guid.cs

Записывает Guid значение (в виде строки 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.

Исключения

InvalidOperationException

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

Комментарии

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

WriteStringValue(ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteValues.String.cs

Записывает текстовое значение UTF-8 (как строку 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>

Закодированное значение UTF-8 в виде строки JSON.

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

WriteStringValue(ReadOnlySpan<Char>)

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

Utf8JsonWriter.WriteValues.String.cs

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

WriteStringValue(String)

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

Utf8JsonWriter.WriteValues.String.cs

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

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

WriteStringValue(JsonEncodedText)

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

Utf8JsonWriter.WriteValues.String.cs

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

Закодированное значение JSON, которое должно быть записано в виде перекодированной строки JSON UTF-8.

Исключения

InvalidOperationException

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

Комментарии

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