Utf8JsonWriter.WriteBase64String Метод

Определение

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

System.Text.Json

Сборка:

System.Text.Json.dll

Перегрузки

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 .

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