Utf8JsonWriter.WriteBase64String Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

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

Перегрузки

Имя	Описание
WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Записывает имя свойства и значение необработанных байтов (в виде строки JSON в кодировке Base64) в составе пары "имя-значение" объекта JSON.
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Записывает имя свойства и значение необработанных байтов (в виде строки JSON в кодировке Base64) в составе пары "имя-значение" объекта JSON.
WriteBase64String(String, ReadOnlySpan<Byte>)	Записывает имя свойства и значение необработанных байтов (в виде строки JSON в кодировке Base64) в составе пары "имя-значение" объекта JSON.
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)	Записывает предварительно закодированное имя свойства и значение необработанных байтов (в виде строки JSON в кодировке Base64) в составе пары имен и значений объекта JSON.

WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.Bytes.cs

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

public:
 void WriteBase64String(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> bytes);

public void WriteBase64String(ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> bytes);

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

Public Sub WriteBase64String (utf8PropertyName As ReadOnlySpan(Of Byte), bytes As ReadOnlySpan(Of Byte))

Параметры

utf8PropertyName

ReadOnlySpan<Byte>

Закодированное имя свойства UTF-8 для записи.

bytes

ReadOnlySpan<Byte>

Двоичные данные для записи в кодировке Base64.

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

Максимальный допустимый размер двоичных данных для записи в base64 составляет 125 000 000 байт (или примерно 125 МБ). Превышение этого ограничения приводит к возникновению ArgumentException ошибки.

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

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

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

Utf8JsonWriter.WriteProperties.Bytes.cs

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

public:
 void WriteBase64String(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> bytes);

public void WriteBase64String(ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> bytes);

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

Public Sub WriteBase64String (propertyName As ReadOnlySpan(Of Char), bytes As ReadOnlySpan(Of Byte))

Параметры

propertyName

ReadOnlySpan<Char>

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

bytes

ReadOnlySpan<Byte>

Двоичные данные для записи в кодировке Base64.

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

Максимальный допустимый размер двоичных данных для записи в base64 составляет 125 000 000 байт (или примерно 125 МБ). Превышение этого ограничения приводит к возникновению ArgumentException ошибки.

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

WriteBase64String(String, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.Bytes.cs

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

public:
 void WriteBase64String(System::String ^ propertyName, ReadOnlySpan<System::Byte> bytes);

public void WriteBase64String(string propertyName, ReadOnlySpan<byte> bytes);

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

Public Sub WriteBase64String (propertyName As String, bytes As ReadOnlySpan(Of Byte))

Параметры

propertyName

String

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

bytes

ReadOnlySpan<Byte>

Двоичные данные для записи в кодировке Base64.

Исключения

ArgumentException

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

InvalidOperationException

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

ArgumentNullException

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

Комментарии

Максимальный допустимый размер двоичных данных для записи в base64 составляет 125 000 000 байт (или примерно 125 МБ). Превышение этого ограничения приводит к возникновению ArgumentException ошибки.

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

WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)

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

Utf8JsonWriter.WriteProperties.Bytes.cs

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

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

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

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

Public Sub WriteBase64String (propertyName As JsonEncodedText, bytes As ReadOnlySpan(Of Byte))

Параметры

propertyName

JsonEncodedText

Закодированное в формате JSON имя свойства для записи.

bytes

ReadOnlySpan<Byte>

Двоичные данные для записи в кодировке Base64.

Исключения

ArgumentException

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

InvalidOperationException

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

Комментарии

Максимальный допустимый размер двоичных данных для записи в base64 составляет 125 000 000 байт (или примерно 125 МБ). Превышение этого ограничения приводит к возникновению ArgumentException ошибки.

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

Байты кодируются перед записью.