Поделиться через


Utf8JsonWriter.WriteStringValue Метод

Определение

Перегрузки

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
Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
Utf8JsonWriter.WriteValues.String.cs

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

Параметры

value
String

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

Исключения

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

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

Комментарии

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

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

Применяется к

WriteStringValue(DateTime)

Исходный код:
Utf8JsonWriter.WriteValues.DateTime.cs
Исходный код:
Utf8JsonWriter.WriteValues.DateTime.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к

WriteStringValue(DateTimeOffset)

Исходный код:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
Исходный код:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к

WriteStringValue(Guid)

Исходный код:
Utf8JsonWriter.WriteValues.Guid.cs
Исходный код:
Utf8JsonWriter.WriteValues.Guid.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к

WriteStringValue(ReadOnlySpan<Byte>)

Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
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.

Исключения

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

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

Комментарии

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

Применяется к

WriteStringValue(ReadOnlySpan<Char>)

Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
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.

Исключения

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

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

Комментарии

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

Применяется к

WriteStringValue(JsonEncodedText)

Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
Utf8JsonWriter.WriteValues.String.cs
Исходный код:
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.

Исключения

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

Комментарии

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

Применяется к