C#のInt64.ToString()メソッドとは？構文と書式指定の実例付きで解説

C#におけるInt64.ToString()メソッドは、Int64型（long型）のインスタンスが持つ数値を、それに相当する文字列表現へ変換するためのメソッドです。数値を画面に表示したり、文字列として連結・保存したりする際に頻繁に利用される、非常に基本的かつ重要なメソッドといえます。

構文

Int64.ToString()メソッドには、主に以下の2つのオーバーロードがあります。

public override string ToString ();
public string ToString (string format);

引数なしのバージョンは、数値を既定の形式で文字列化します。一方、formatパラメータには数値書式指定文字列（例："D8" や "X" など）を渡すことができ、出力される文字列の形式を細かく制御できます。

使用例1：基本的なToString()の呼び出し

まずは、最もシンプルな使い方を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      long val1 = 0;
      long val2 = Int64.MaxValue;
      Console.WriteLine("Value1 = "+val1.ToString());
      Console.WriteLine("Value2 = "+val2.ToString());
      Console.WriteLine("Are they equal? = "+val1.Equals(val2));
      Console.WriteLine("Value1 (HashCode) = "+val1.GetHashCode());
      Console.WriteLine("Value2 (HashCode) = "+val2.GetHashCode());
      TypeCode type1 = val1.GetTypeCode();
      TypeCode type2 = val2.GetTypeCode();
      Console.WriteLine("TypeCode for val1 = "+val1.GetTypeCode());
      Console.WriteLine("TypeCode for val2 = "+val2.GetTypeCode());
   }
}

出力結果

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

Value1 = 0
Value2 = 9223372036854775807
Are they equal? = False
Value1 (HashCode) = 0
Value2 (HashCode) = -2147483648
TypeCode for val1 = Int64
TypeCode for val2 = Int64

この例では、Int64.MaxValue（long型が表現できる最大値 9,223,372,036,854,775,807）をToString()メソッドで文字列化しています。また、GetTypeCode()メソッドにより、両方の値のTypeCodeが「Int64」であることも確認できます。

使用例2：書式指定文字列を使ったToString()

続いて、書式指定文字列を渡した場合の例です。

using System;
public class Demo {
   public static void Main(){
      long val1 = 87987687;
      long val2 = 35436367;
      Console.WriteLine("Value1 = "+val1.ToString("D8"));
      Console.WriteLine("Value2 = "+val2.ToString("X"));
      Console.WriteLine("Are they equal? = "+val1.Equals(val2));
      Console.WriteLine("Value1 (HashCode) = "+val1.GetHashCode());
      Console.WriteLine("Value2 (HashCode) = "+val2.GetHashCode());
      TypeCode type1 = val1.GetTypeCode();
      TypeCode type2 = val2.GetTypeCode();
      Console.WriteLine("TypeCode for val1 = "+val1.GetTypeCode());
      Console.WriteLine("TypeCode for val2 = "+val2.GetTypeCode());
   }
}

出力結果

実行すると、以下の出力が得られます。

Value1 = 87987687
Value2 = 21CB74F
Are they equal? = False
Value1 (HashCode) = 87987687
Value2 (HashCode) = 35436367
TypeCode for val1 = Int64
TypeCode for val2 = Int64

書式指定子のポイント

• "D8"（10進数書式）： 数値を10進表記の文字列に変換し、桁数が8桁に満たない場合は左側をゼロで埋めます。この例では元々8桁あるため、そのまま「87987687」と出力されています。
• "X"（16進数書式）： 数値を大文字の16進表記に変換します。35436367は「21CB74F」として出力されます。小文字で出力したい場合は"x"を使用します。

このように、Int64.ToString()メソッドを使いこなすことで、数値データを目的の形式の文字列へ柔軟に変換でき、ログ出力や画面表示、ファイルへの書き込みなど、さまざまな場面で活用できます。