Utf8JsonWriter.WriteString Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

System.Text.Json v9.0.0-rc.2.24473.5

Перегрузки

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

WriteString(JsonEncodedText, JsonEncodedText)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает заранее закодированные имя свойства и значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

JsonEncodedText

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

Исключения

InvalidOperationException

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

Комментарии

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

WriteString(JsonEncodedText, String)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает заранее закодированное имя свойства и строковое текстовое значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);

member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

String

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает заранее закодированное имя свойства и текстовое значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

ReadOnlySpan<Char>

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает заранее закодированное имя свойства и текстовое значение в UTF-8 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

utf8Value

ReadOnlySpan<Byte>

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

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

WriteString(JsonEncodedText, Guid)

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

Utf8JsonWriter.WriteProperties.Guid.cs

Записывает заранее закодированное имя свойства и значение Guid (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);

member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

Guid

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

Исключения

InvalidOperationException

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

Комментарии

Записывает объект , Guid используя значение по умолчанию StandardFormat (то есть "D") в формате nnnnnnnn-nnnn-nnnn-nnnnnn-nnnnnnnn.

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

WriteString(JsonEncodedText, DateTimeOffset)

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

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Записывает заранее закодированное имя свойства и значение DateTimeOffset (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

DateTimeOffset

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

Исключения

InvalidOperationException

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

Комментарии

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

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

WriteString(JsonEncodedText, DateTime)

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

Utf8JsonWriter.WriteProperties.DateTime.cs

Записывает заранее закодированное имя свойства и значение DateTime (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

Параметры

propertyName

JsonEncodedText

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке JSON.

value

DateTime

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

Исключения

InvalidOperationException

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

Комментарии

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

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

WriteString(String, JsonEncodedText)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства и заранее закодированное значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8.

value

JsonEncodedText

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(String, String)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства, указываемое как строка, и строковое текстовое значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

member this.WriteString : string * string -> unit

Public Sub WriteString (propertyName As String, value As String)

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

String

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

Имя и значение свойства экранируются перед записью.

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

WriteString(String, ReadOnlySpan<Char>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства, указываемое как строка, и текстовое значение UTF-16 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);

public void WriteString (string propertyName, ReadOnlySpan<char> value);

member this.WriteString : string * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

ReadOnlySpan<Char>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(String, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства, указываемое как строка, и текстовое значение UTF-8 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : string * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

utf8Value

ReadOnlySpan<Byte>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(String, DateTimeOffset)

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

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Записывает имя свойства, указываемое как строка, и значение DateTimeOffset (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, DateTimeOffset value);

public void WriteString (string propertyName, DateTimeOffset value);

member this.WriteString : string * DateTimeOffset -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

DateTimeOffset

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(String, DateTime)

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

Utf8JsonWriter.WriteProperties.DateTime.cs

Записывает имя свойства, указываемое как строка, и значение DateTime (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, DateTime value);

public void WriteString (string propertyName, DateTime value);

member this.WriteString : string * DateTime -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

DateTime

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(String, Guid)

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

Utf8JsonWriter.WriteProperties.Guid.cs

Записывает имя свойства, указываемое как строка, и значение Guid (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(System::String ^ propertyName, Guid value);

public void WriteString (string propertyName, Guid value);

member this.WriteString : string * Guid -> unit

Public Sub WriteString (propertyName As String, value As Guid)

Параметры

propertyName

String

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

Guid

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

ArgumentNullException

Параметр propertyName имеет значение null.

Комментарии

Записывает объект , Guid используя значение по умолчанию StandardFormat (то есть "D") в формате nnnnnnnn-nnnn-nnnn-nnnnnn-nnnnnnnn. Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, String)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-16 и строковое текстовое значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<char> propertyName, string? value);

member this.WriteString : ReadOnlySpan<char> * string -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

String

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

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

WriteString(ReadOnlySpan<Byte>, DateTime)

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

Utf8JsonWriter.WriteProperties.DateTime.cs

Записывает имя свойства UTF-8 и значение DateTime (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);

member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

DateTime

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

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

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Записывает имя свойства UTF-8 и значение DateTimeOffset (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

DateTimeOffset

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства и заранее закодированное значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8.

value

JsonEncodedText

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-8 и текстовое значение UTF-8 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

utf8Value

ReadOnlySpan<Byte>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-8 и текстовое значение UTF-16 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

ReadOnlySpan<Char>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(ReadOnlySpan<Byte>, String)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-8 и строковое текстовое значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);

member this.WriteString : ReadOnlySpan<byte> * string -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

String

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

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

WriteString(ReadOnlySpan<Byte>, Guid)

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

Utf8JsonWriter.WriteProperties.Guid.cs

Записывает имя свойства UTF-8 и значение Guid (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);

member this.WriteString : ReadOnlySpan<byte> * Guid -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

Guid

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

Записывает объект , Guid используя значение по умолчанию StandardFormat (то есть "D") в формате nnnnnnnn-nnnn-nnnn-nnnnnn-nnnnnnnn. Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, DateTime)

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

Utf8JsonWriter.WriteProperties.DateTime.cs

Записывает имя свойства, указываемое как доступный только для чтения диапазон символов, и значение DateTime (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTime value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);

member this.WriteString : ReadOnlySpan<char> * DateTime -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

DateTime

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

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

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Записывает имя свойства, указываемое как доступный только для чтения диапазон символов, и значение DateTimeOffset (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

DateTimeOffset

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, Guid)

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

Utf8JsonWriter.WriteProperties.Guid.cs

Записывает имя свойства, указываемое как доступный только для чтения диапазон символов, и значение Guid (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, Guid value);

public void WriteString (ReadOnlySpan<char> propertyName, Guid value);

member this.WriteString : ReadOnlySpan<char> * Guid -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

Guid

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

Записывает объект , Guid используя значение по умолчанию StandardFormat (то есть "D") в формате nnnnnnnn-nnnn-nnnn-nnnnnn-nnnnnnnn. Имя свойства экранируется перед записью.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-16 и текстовое значение UTF-8 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

utf8Value

ReadOnlySpan<Byte>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства UTF-16 и текстовое значение UTF-16 (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

Параметры

propertyName

ReadOnlySpan<Char>

Имя свойства объекта JSON, который нужно перекодировать и записать в формате UTF-8, в кодировке UTF-16.

value

ReadOnlySpan<Char>

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

Исключения

ArgumentException

Имя или значение указанного свойства слишком велико.

InvalidOperationException

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

Комментарии

Имя и значение свойства экранируются перед записью.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

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

Utf8JsonWriter.WriteProperties.String.cs

Записывает имя свойства в кодировке UTF-8 и заранее закодированное значение (в виде строки JSON) в составе пары "имя-значение" объекта JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Имя свойства объекта JSON, который нужно записать, в кодировке UTF-8.

value

JsonEncodedText

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

Исключения

ArgumentException

Имя указанного свойства слишком длинное.

InvalidOperationException

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

Комментарии

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

Имя свойства экранируется перед записью.