Utf8JsonWriter.WriteBase64String 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

System.Text.Json v9.0.0-preview.3.24172.9

重载

WriteBase64String(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 JSON 对象的名称/值对。
WriteBase64String(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 JSON 对象的名称/值对。
WriteBase64String(String, ReadOnlySpan<Byte>)	将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 JSON 对象的名称/值对。
WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)	将预编码属性名称和原始字节值（作为 Base64 编码的 JSON 字符串）编写为 JSON 对象的名称/值对的一部分。

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

Source:

Utf8JsonWriter.WriteProperties.Bytes.cs

将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 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 MB) 。 超过此限制会导致 ArgumentException 引发 。

属性名称将转义，并在写入之前对字节进行编码。

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

Source:

Utf8JsonWriter.WriteProperties.Bytes.cs

将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 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>

要进行转码并写为 UTF-8 的 JSON 对象的属性名称。

bytes

ReadOnlySpan<Byte>

要编写为 Base64 编码文本的二进制数据。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

系统已启用验证，此方法将导致编写无效的 JSON。

注解

作为 Base64 写入的二进制数据允许的最大大小为 125，000，000 字节 (或大约 125 MB) 。 超过此限制会导致 ArgumentException 引发 。

属性名称将转义，并在写入之前对字节进行编码。

WriteBase64String(String, ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteProperties.Bytes.cs

将属性名称和原始字节值（作为 Base 64 编码的 JSON 字符串）写入 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

要进行转码并写为 UTF-8 的 JSON 对象的属性名称。

bytes

ReadOnlySpan<Byte>

要编写为 Base64 编码文本的二进制数据。

例外

ArgumentException

指定的属性名称或值太大。

InvalidOperationException

系统已启用验证，此方法将导致编写无效的 JSON。

ArgumentNullException

propertyName 参数为 null。

注解

作为 Base64 写入的二进制数据允许的最大大小为 125，000，000 字节 (或大约 125 MB) 。 超过此限制会导致 ArgumentException 引发 。

属性名称将转义，并在写入之前对字节进行编码。

WriteBase64String(JsonEncodedText, ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteProperties.Bytes.cs

将预编码属性名称和原始字节值（作为 Base64 编码的 JSON 字符串）编写为 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 MB) 。 超过此限制会导致 ArgumentException 引发 。

创建 实例 JsonEncodedText 时，属性名称应已转义。

在写入之前对字节进行编码。