Base64.EncodeToUtf8 方法

定义

命名空间:

System.Buffers.Text

程序集:

System.Runtime.dll

Source:

Base64Encoder.cs

将二进制数据的范围编码为以 base 64 表示的 UTF-8 编码的文本。

public static System.Buffers.OperationStatus EncodeToUtf8 (ReadOnlySpan<byte> bytes, Span<byte> utf8, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);

static member EncodeToUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus

Public Shared Function EncodeToUtf8 (bytes As ReadOnlySpan(Of Byte), utf8 As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus

参数

bytes

ReadOnlySpan<Byte>

包含需要编码的二进制数据的输入范围。

utf8

Span<Byte>

包含操作结果（即以 base 64 表示的 UTF-8 编码的文本）的输出范围。

bytesConsumed

Int32

此方法返回时，包含操作期间使用的输入字节数。 如有必要，这可用于划分输入以供后续调用。

bytesWritten

Int32

此方法返回时，包含写入输出范围的字节数。 如有必要，这可用于划分输出以供后续调用。

isFinalBlock

Boolean

true (默认) ，以指示输入范围包含要编码的整个数据。 false 以指示输入范围包含部分数据，以及更多要关注的数据。

返回

OperationStatus

用于指示编码操作状态的枚举值之一。

注解

返回值可如下所示：

• OperationStatus.Done：处理整个输入范围成功。
• OperationStatus.DestinationTooSmall：输出范围中没有足够的空间来容纳编码的输入。
• OperationStatus.NeedMoreData： isFinalBlock 为 false。 否则，如果 isFinalBlock 为 true，则如果输入不是 3 的倍数，则填充输出。

此方法无法返回，因为 base-64 编码无法返回 OperationStatus.InvalidData 。