C#のToTuple()メソッドとは？ValueTupleからTupleへの変換方法を解説

C#プログラミングにおいて、ValueTuple（値タプル）をTuple（参照タプル）に変換したい場面があります。そんなときに活躍するのが ToTuple() メソッドです。このメソッドを使えば、わずか1行のコードで簡単に変換を行うことができます。

ToTuple()メソッドの基本

ToTuple() メソッドは、ValueTupleのインスタンスに対して呼び出すことで、同じ要素を持つ Tuple<T1, T2, ...> クラスのインスタンスを生成して返します。戻り値は不変（イミュータブル）な参照型のタプルとなるため、既存のAPIがTuple型を要求している場合などに便利です。

事前準備：System.ValueTupleパッケージの追加

ValueTupleを使用したプログラムを実行するには、System.ValueTuple パッケージをプロジェクトに追加する必要があります。追加手順は以下の通りです。

• Visual Studioで対象のプロジェクトを開きます。
• ソリューションエクスプローラーでプロジェクトを右クリックします。
• 「NuGetパッケージの管理」を選択します。
• NuGetパッケージマネージャー画面が表示されます。
• 「参照」タブをクリックし、検索ボックスに「ValueTuple」と入力します。
• 「System.ValueTuple」パッケージを選択してインストールします。

なお、.NET Framework 4.7以降や .NET Core 2.0以降ではValueTupleが標準で組み込まれているため、この手順は不要です。

ToTuple()メソッドの実装例

それでは、実際に ToTuple() メソッドを使ったサンプルコードを見てみましょう。

using System;
class Program {
   static void Main() {
      var val = (1, 2, 3);

      // ValueTupleの表示
      Console.WriteLine("ValueTuple: " + val);

      // ToTuple()メソッドでTupleへ変換
      Tuple<int, int, int> myTuple = val.ToTuple();

      // 変換後のTupleの表示
      Console.WriteLine("Tuple: " + myTuple);
   }
}

実行結果

ValueTuple: (1, 2, 3)
Tuple: (1, 2, 3)

コードの解説

このサンプルでは、まず (1, 2, 3) という3つのint型要素を持つValueTupleを作成しています。次に val.ToTuple() を呼び出すことで、同じ値を持つ Tuple<int, int, int> 型のオブジェクトに変換しています。実行結果を見ると、どちらも同じ (1, 2, 3) という値が出力されており、要素の内容がそのまま保持されていることが確認できます。

まとめ

ToTuple() メソッドを使うことで、軽量なValueTupleから従来の参照型であるTupleへシームレスに変換できます。逆にTupleからValueTupleへ変換したい場合は ToValueTuple() メソッドを使用します。用途に応じて両者を使い分けることで、より柔軟なC#プログラミングが可能になります。