StringBuilder クラス
可変型の文字列を表します。このクラスは継承できません。
この型のすべてのメンバの一覧については、StringBuilder メンバ を参照してください。
System.Object
System.Text.StringBuilder
<Serializable>
NotInheritable Public Class StringBuilder
[C#]
[Serializable]
public sealed class StringBuilder
[C++]
[Serializable]
public __gc __sealed class StringBuilder
[JScript]
public
Serializable
class StringBuilder
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
このクラスは、可変型の文字のシーケンスである値を持つ、文字列のようなオブジェクトを表します。文字を追加、削除、置換または挿入して値を作成した後にその値を変更できるため、値が可変型と呼ばれます。比較のため、 String クラスのトピックを参照してください。
このクラスのインスタンスを変更するメソッドの多くは、同じインスタンスへの参照を返します。インスタンスへの参照が返されるため、参照に対してメソッドまたはプロパティを呼び出すことができます。これは、連続した操作を次々にチェイン化する単一のステートメントを書く場合に役立ちます。
StringBuilder の容量は、インスタンスが指定した時間に格納できる最大文字数で、インスタンスの値の文字列形式の長さ以上です。容量は、 Capacity プロパティまたは EnsureCapacity メソッドを使用して増減できます。ただし、 Length プロパティの値より小さくすることはできません。
StringBuilder のインスタンスが初期化されるときに、容量または最大容量が指定されなかった場合は、実装に固有の既定の容量が使用されます。
実装時の注意: この実装の既定容量は 16 で、既定の最大容量は Int32.MaxValue です。
StringBuilder は、インスタンスの値が大きくなった場合に、文字を格納するために必要なより多くのメモリを割り当てることができます。それに応じて容量が調整されます。割り当てられたメモリの量が実装固有で、必要なメモリ量が最大容量より大きい場合は、 ArgumentOutOfRangeException がスローされます。
たとえば、 Append メソッド、 AppendFormat メソッド、 EnsureCapacity メソッド、 Insert メソッド、および Replace メソッドはインスタンスの値を拡大できます。
StringBuilder の値内の個別の文字は、 Chars プロパティを使用してアクセスできます。インデックスの位置は 0 から始まります。
必要条件
名前空間: System.Text
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: Mscorlib (Mscorlib.dll 内)