Utf8JsonWriter.WriteString Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

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

Перегрузки

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

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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

value

Guid

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

Исключения

InvalidOperationException

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

Комментарии

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

Имя свойства уже должно быть экранировано при создании экземпляра 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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

value

DateTimeOffset

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

Исключения

InvalidOperationException

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

Комментарии

DateTimeOffset Записывает расширенный формат ISO 8601-1 (см. поддержку DateTime и DateTimeOffset в System.Text.Json); например, 2017-06-12T05:30:45.76800000-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 имя свойства объекта JSON, которое должно быть перекодировано и записано как UTF-8.

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

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

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

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

value

ReadOnlySpan<Char>

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

Исключения

ArgumentException

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

InvalidOperationException

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

ArgumentNullException

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

Комментарии

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

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

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

value

Guid

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

ArgumentNullException

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

Комментарии

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

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

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

value

DateTimeOffset

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

ArgumentNullException

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

Комментарии

DateTimeOffset Записывает расширенный формат ISO 8601-1 (см. поддержку DateTime и DateTimeOffset в System.Text.Json); например, 2017-06-12T05:30:45.76800000-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

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

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, 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

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

utf8Value

ReadOnlySpan<Byte>

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

Исключения

ArgumentException

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

InvalidOperationException

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

ArgumentNullException

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

Комментарии

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

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>

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

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

value

DateTime

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

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

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

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>, 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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

value

Guid

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

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

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

value

String

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

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

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

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

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

value

DateTimeOffset

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

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

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

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>

Имя свойства в кодировке UTF-16 объекта 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<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>

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

value

DateTimeOffset

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

DateTimeOffset Записывает расширенный формат ISO 8601-1 (см. поддержку DateTime и DateTimeOffset в System.Text.Json); например, 2017-06-12T05:30:45.76800000-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>

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

value

Guid

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

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

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>

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

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>

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

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>

Имя свойства в кодировке UTF-8 для записи объекта JSON.

value

JsonEncodedText

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

Исключения

ArgumentException

Указанное имя свойства слишком велико.

InvalidOperationException

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

Комментарии

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

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