【C#】Convert.ToBase64CharArray()メソッドの使い方をサンプルコード付きで解説

C#のConvert.ToBase64CharArray()メソッドは、8ビット符号なし整数（byte）配列の一部分を、base-64形式でエンコードされたUnicode文字（char）配列の対応する部分に変換するための静的メソッドです。バイナリデータをテキストとして安全に扱いたい場合などに活用できます。

構文

ToBase64CharArray()メソッドの構文は以下の通りです。

public static int ToBase64CharArray (byte[] arr, int offsetIn, int length, char[] outArray, int offsetOut);

パラメータ

• arr：変換元となる8ビット符号なし整数（byte）の入力配列。
• offsetIn：arrのうち変換を開始する位置（インデックス）。
• length：変換対象となるarrの要素数。
• outArray：変換結果を格納するUnicode文字（char）の出力配列。
• offsetOut：outArrayのうち書き込みを開始する位置（インデックス）。

戻り値は、outArrayに実際に書き込まれたバイト数（要素数）を表すint型の値です。

使用例

それでは、Convert.ToBase64CharArray()メソッドを実装した具体的な例を見てみましょう。

using System;

public class Demo {
   public static void Main() {
      // 入力用のbyte型配列
      byte[] val1 = {5,10,15,20,25,30};

      // Base64変換後に必要な文字数を算出（4/3倍して5の倍数に切り上げ）
      long arrLen = (long)((4.0d / 3.0d) * val1.Length);
      if (arrLen % 5 != 0)
         arrLen += 5 - arrLen % 5;

      // 変換結果を格納するchar型配列
      char[] base64CharArray = new char[arrLen];

      // ToBase64CharArray()メソッドで変換を実行
      int res = Convert.ToBase64CharArray(val1, 0, val1.Length, base64CharArray, 0);

      Console.WriteLine("Bytes (count) = "+ res);
      Console.Write("Our base64CharArray...\n");
      for (int j = 0; j < base64CharArray.Length; j++)
         Console.Write("{0}", base64CharArray[j]);
   }
}

出力結果

上記のコードを実行すると、次のような結果が出力されます。

Bytes (count) = 8
Our base64CharArray...
BQoPFBke

この例では、6バイトのデータ {5,10,15,20,25,30} がbase-64エンコードされ、「BQoPFBke」という8文字の文字列に変換されていることがわかります。このように、ToBase64CharArray()メソッドを使うことで、byte配列の内容を手軽にbase-64形式の文字データへ変換できます。