C#のStringBuilder.ToString()メソッドとは？使い方とサンプルコードを解説

C#におけるStringBuilder.ToString()メソッドは、StringBuilderオブジェクトが保持している値をString（文字列）型に変換するためのメソッドです。可変長の文字列を効率的に操作できるStringBuilderから、通常の不変（immutable）な文字列として内容を取り出したい場面でよく使用されます。

構文

ToString()メソッドには、以下の2つのオーバーロードが用意されています。

public override string ToString ();
public string ToString (int begnIndex, int len);

1つ目は引数なしのバージョンで、StringBuilder全体の内容を文字列として返します。2つ目はパラメータを2つ受け取るバージョンで、begnIndexはこのインスタンス内における部分文字列の開始位置、lenは部分文字列の長さを表します。指定した範囲の部分文字列だけをStringとして取得することが可能です。

使用例1：ToString()の基本動作

まずは、基本的な使い方を確認してみましょう。

using System;
using System.Text;
public class Demo{
   public static void Main(){
      StringBuilder strBuilder = new StringBuilder("Katie");
      Console.WriteLine("String = "+strBuilder.ToString());
      Console.WriteLine("\nStringBuilder capacity = "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
      strBuilder.EnsureCapacity(35);
      Console.WriteLine("\nStringBuilder capacity= "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
      strBuilder.EnsureCapacity(0);
      strBuilder.Length = 0;
      Console.WriteLine("\nStringBuilder capacity= "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
   }
}

出力

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

String = Katie
StringBuilder capacity = 16
StringBuilder length = 5
StringBuilder capacity= 35
StringBuilder length = 5
StringBuilder capacity= 35
StringBuilder length = 0

この例では、初期値「Katie」を持つStringBuilderを作成し、ToString()メソッドで文字列として出力しています。その後、EnsureCapacity(35)を呼び出すことで容量（Capacity）が16から35に拡張されますが、実際の文字数を示すLengthは5のまま変化しない点に注目してください。最後にLengthプロパティを0に設定することで、StringBuilderの内容をクリアしています。

使用例2：開始位置と長さを指定した部分文字列の取得

続いて、ToString(int begnIndex, int len)を使って部分文字列を取得する例を見てみましょう。

using System;
using System.Text;
public class Demo{
   public static void Main(){
      StringBuilder strBuilder = new StringBuilder("TomHanks");
      Console.WriteLine("StringBuilder = "+strBuilder.ToString());
      Console.WriteLine("String = "+strBuilder.ToString(3, 5));
      Console.WriteLine("\nStringBuilder capacity = "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
      strBuilder.EnsureCapacity(35);
      Console.WriteLine("\nStringBuilder capacity= "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
      strBuilder.EnsureCapacity(0);
      strBuilder.Length = 0;
      Console.WriteLine("\nStringBuilder capacity= "+strBuilder.Capacity);
      Console.WriteLine("StringBuilder length = "+strBuilder.Length);
   }
}

出力

実行結果は以下の通りです。

StringBuilder = TomHanks
String = Hanks
StringBuilder capacity = 16
StringBuilder length = 8
StringBuilder capacity= 35
StringBuilder length = 8
StringBuilder capacity= 35
StringBuilder length = 0

ここでは、ToString(3, 5)と呼び出すことで、インデックス3の位置から5文字分の部分文字列を取得しています。その結果、「TomHanks」のうち「Hanks」だけがStringとして返されていることがわかります。このように、引数付きのToString()を使えば、StringBuilder内の任意の範囲を簡単に切り出すことができます。