C#のConvert.ToBase64String()メソッドの使い方を徹底解説

C#のConvert.ToBase64String()メソッドは、8ビット符号なし整数（byte）の配列の値を、Base64形式でエンコードされた文字列に変換するために使用されるメソッドです。バイナリデータをテキストとして扱いたい場合や、データを安全に文字列として送受信したい場合などに広く活用されています。

構文

Convert.ToBase64String()メソッドの構文は以下のとおりです。

public static string ToBase64String (byte[] arr);

引数arrには、変換対象となる8ビット符号なし整数（byte型）の配列を指定します。戻り値として、Base64でエンコードされた文字列が返されます。

使用例

それでは、Convert.ToBase64String()メソッドを使った具体的なサンプルコードを見てみましょう。以下の例では、byte配列をBase64文字列に変換し、さらにConvert.FromBase64String()メソッドを使って元のbyte配列に復元しています。

using System;
public class Demo {
   public static void Main(){
      byte[] val1 = {5,10,15,20,25,30};
      string str = Convert.ToBase64String(val1);
      Console.WriteLine("Base 64 string: '{0}'", str);
      byte[] val2 = Convert.FromBase64String(str);
      Console.WriteLine("Converted byte value: {0}", BitConverter.ToString(val2));
   }
}

実行結果

上記のプログラムを実行すると、以下のような出力が得られます。

Base 64 string: 'BQoPFBke'
Converted byte value: 05-0A-0F-14-19-1E

解説

まず、{5,10,15,20,25,30}というbyte配列をConvert.ToBase64String()メソッドに渡すことで、Base64エンコードされた文字列「BQoPFBke」が生成されます。その後、Convert.FromBase64String()メソッドを使用してこの文字列をデコードし、元のbyte配列に戻していることがわかります。BitConverter.ToString()メソッドにより、各バイト値が16進数表記で表示されている点にも注目してください。

このように、ToBase64String()とFromBase64String()は対になるメソッドであり、データのエンコード・デコードを相互に行うことができます。画像ファイルや暗号化データなどをテキスト形式で保存・転送する際に非常に便利な機能です。