C# バイト型配列をそのまま文字列に変換する方法

このサイトはプロモーションを含みます

2024年9月8日2024年11月29日

案件獲得サイト

エンジニアスタイルとは

アビリティクラウドとは

未経験歓迎転職（手取り20万以下の人は絶対転職して！！）

ユニゾンキャリア

テックハブニュービー

C#でプログラミングをしていると、バイト型配列（byte[]）を扱う機会が多くあります。特にファイルの読み込みやネットワーク通信を行う際に、データがバイト配列として渡されることがよくあります。そんな時、バイト配列をそのまま文字列に変換したいと思ったことはありませんか？この記事では、C#でバイト型配列を直接文字列に変換する方法を、初心者の方にも分かりやすく解説します。

なぜバイト配列を文字列に変換するのか？

バイト配列を文字列に変換する主な理由は以下の通りです：

デバッグ時にバイト配列の内容を簡単に確認したい
バイナリデータを人間が読める形式で表示したい
バイト配列をそのままテキストファイルに保存したい

それでは、具体的な変換方法を見ていきましょう。

方法1: BitConverter.ToStringを使用する

BitConverter.ToString()メソッドを使用すると、バイト配列を16進数の文字列に簡単に変換できます。

using System;

class ByteArrayToStringExample
{
    static void Main()
    {
        // サンプルのバイト配列
        byte[] byteArray = { 72, 101, 108, 108, 111, 33 };  // "Hello!" のASCII値

        // BitConverter.ToString()を使用して変換
        string result = BitConverter.ToString(byteArray);
        Console.WriteLine("BitConverter.ToString()の結果:");
        Console.WriteLine(result);  // 出力: 48-65-6C-6C-6F-21

        // ハイフンを除去する場合
        string resultWithoutHyphens = BitConverter.ToString(byteArray).Replace("-", "");
        Console.WriteLine("ハイフンを除去した結果:");
        Console.WriteLine(resultWithoutHyphens);  // 出力: 48656C6C6F21
    }
}

この方法は、バイト配列の各バイトを2桁の16進数で表現し、デフォルトではハイフン（-）で区切ります。ハイフンが不要な場合は、Replace()メソッドを使って除去できます。

方法2: カスタム関数を使用する

より柔軟な変換が必要な場合は、カスタム関数を作成することができます。以下は、バイト配列を16進数文字列に変換するカスタム関数の例です。

using System;
using System.Text;

class CustomByteArrayToStringExample
{
    static void Main()
    {
        byte[] byteArray = { 72, 101, 108, 108, 111, 33 };  // "Hello!" のASCII値

        string result = ByteArrayToHexString(byteArray);
        Console.WriteLine("カスタム関数の結果:");
        Console.WriteLine(result);  // 出力: 48656C6C6F21
    }

    static string ByteArrayToHexString(byte[] byteArray)
    {
        StringBuilder hex = new StringBuilder(byteArray.Length * 2);
        foreach (byte b in byteArray)
        {
            hex.AppendFormat("{0:X2}", b);
        }
        return hex.ToString();
    }
}

このカスタム関数では、StringBuilderを使用して効率的に文字列を構築しています。各バイトを2桁の16進数に変換し、最後に完成した文字列を返します。

方法3: System.Text.Encodingを使用する

バイト配列が特定の文字エンコーディング（UTF-8やASCIIなど）で表現されている場合は、System.Text.Encodingクラスを使用して直接文字列に変換できます。

using System;
using System.Text;

class EncodingByteArrayToStringExample
{
    static void Main()
    {
        byte[] byteArray = { 72, 101, 108, 108, 111, 33 };  // "Hello!" のASCII値

        // ASCIIエンコーディングを使用
        string asciiResult = Encoding.ASCII.GetString(byteArray);
        Console.WriteLine("ASCIIエンコーディングの結果:");
        Console.WriteLine(asciiResult);  // 出力: Hello!

        // UTF-8エンコーディングを使用
        string utf8Result = Encoding.UTF8.GetString(byteArray);
        Console.WriteLine("UTF-8エンコーディングの結果:");
        Console.WriteLine(utf8Result);  // 出力: Hello!
    }
}

この方法は、バイト配列が実際のテキストデータを表している場合に適しています。適切なエンコーディングを選択することが重要です。