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


Utf8JsonWriter.WriteString Метод

Определение

Перегрузки

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
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары "имя-значение".

Исключения

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

Комментарии

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

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

WriteString(JsonEncodedText, String)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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);
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, в составе пары "имя-значение".

Исключения

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

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

Комментарии

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

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

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары "имя-значение".

Исключения

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

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

Комментарии

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

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

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

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

WriteString(JsonEncodedText, Guid)

Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

Комментарии

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

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

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

WriteString(JsonEncodedText, DateTimeOffset)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

Проверка включена, и операция записи приведет к получению недопустимого 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
Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

Комментарии

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

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

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

WriteString(String, JsonEncodedText)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары "имя-значение".

Исключения

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

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

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

Комментарии

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

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

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

WriteString(String, String)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs

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

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);
public void WriteString (string propertyName, 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, в составе пары имя-значение.

Исключения

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

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

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

Комментарии

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

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

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

WriteString(String, ReadOnlySpan<Char>)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары имя-значение.

Исключения

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

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

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

Комментарии

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

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

WriteString(String, ReadOnlySpan<Byte>)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

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

Комментарии

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

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

WriteString(String, DateTimeOffset)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Параметр 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
Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

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

Комментарии

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

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

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

WriteString(String, Guid)

Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

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

Комментарии

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

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

WriteString(ReadOnlySpan<Char>, String)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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);
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, в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

WriteString(ReadOnlySpan<Byte>, DateTime)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

Проверка включена, и операция записи приведет к получению недопустимого 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
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары "имя-значение".

Исключения

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

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

Комментарии

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

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

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

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

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

WriteString(ReadOnlySpan<Byte>, String)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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);
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, в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

WriteString(ReadOnlySpan<Byte>, Guid)

Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

WriteString(ReadOnlySpan<Char>, DateTime)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTime.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
Utf8JsonWriter.WriteProperties.DateTimeOffset.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

Проверка включена, и операция записи приведет к получению недопустимого 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
Исходный код:
Utf8JsonWriter.WriteProperties.Guid.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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 в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

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

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары имя-значение.

Исключения

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

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

Комментарии

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

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

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
Utf8JsonWriter.WriteProperties.String.cs
Исходный код:
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, в составе пары "имя-значение".

Исключения

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

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

Комментарии

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

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

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