Base64.EncodeToUtf8 メソッド

定義

名前空間:

System.Buffers.Text

アセンブリ:

System.Runtime.dll

ソース:

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

エンコード操作の状態を示す列挙値の 1 つ。

注釈

戻り値は次のようになります。

• OperationStatus.Done: 入力スパン全体の処理に成功しました。
• OperationStatus.DestinationTooSmall: エンコードされた入力に合わせて出力スパンに十分な領域がありません。
• OperationStatus.NeedMoreData: isFinalBlock は です false。 それ以外の場合、 が trueの場合isFinalBlock、入力が 3 の倍数でない場合、出力は埋め込まれます。

base-64 エンコードではこれができないため、このメソッドは を返 OperationStatus.InvalidData すことができません。