C# StringBuilder用法

String 物件是不可改變的。每次使用 System.String 類中的方法之一時，都要在記憶體中建立一個新的字串物件，這就需要為該新物件分配新的空間。在需要對字串執行重複修改的情況下，與建立新的 String 物件相關的系統開銷可能會非常昂貴。如果要修改字串而不建立新的物件，則可以使用 System.Text.StringBuilder 類。例如，當在一個迴圈中將許多字串連線在一起時，使用 StringBuilder 類可以提升效能。

通過用一個過載的建構函式方法初始化變數，可以建立 StringBuilder 類的新例項，正如以下示例中所闡釋的那樣。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!");

設定容量和長度 
雖然 StringBuilder 物件是動態物件，允許擴充它所封裝的字串中字元的數量，但是您可以為它可容納的最大字元數指定一個值。此值稱為該物件的容量，不應將它與當前 StringBuilder 物件容納的字串長度混淆在一起。例如，可以建立 StringBuilder 類的帶有字串“Hello”（長度為 5）的一個新例項，同時可以指定該物件的最大容量為 25。當修改 StringBuilder 時，在達到容量之前，它不會為其自己重新分配空間。當達到容量時，將自動分配新的空間且容量翻倍。可以使用過載的建構函式之一來指定 StringBuilder 類的容量。以下程式碼示例指定可以將 MyStringBuilder 物件擴充到最大 25 個空白。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25);

另外，可以使用讀/寫 Capacity 屬性來設定物件的最大長度。以下程式碼示例使用 Capacity 屬性來定義物件的最大長度。

[C#] 

MyStringBuilder.Capacity = 25;

EnsureCapacity 方法可用來檢查當前 StringBuilder 的容量。如果容量大於傳遞的值，則不進行任何更改；但是，如果容量小於傳遞的值，則會更改當前的容量以使其與傳遞的值匹配。

也可以檢視或設定 Length 屬性。如果將 Length 屬性設定為大於 Capacity 屬性的值，則自動將 Capacity 屬性更改為與 Length 屬性相同的值。如果將 Length 屬性設定為小於當前 StringBuilder 物件內的字串長度的值，則會縮短該字串。

修改 StringBuilder 字串 
下表列出了可以用來修改 StringBuilder 的內容的方法。

方法名 使用 
StringBuilder.Append 將資訊追加到當前 StringBuilder 的結尾。 
StringBuilder.AppendFormat 用帶格式文字替換字串中傳遞的格式說明符。 
StringBuilder.Insert 將字串或物件插入到當前 StringBuilder 物件的指定索引處。 
StringBuilder.Remove 從當前 StringBuilder 物件中移除指定數量的字元。 
StringBuilder.Replace 替換指定索引處的指定字元。

Append 
Append 方法可用來將文字或物件的字串表示形式新增到由當前 StringBuilder 物件表示的字串的結尾處。以下示例將一個 StringBuilder 物件初始化為“Hello World”，然後將一些文字追加到該物件的結尾處。將根據需要自動分配空間。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); 
MyStringBuilder.Append(" What a beautiful day."); 
Console.WriteLine(MyStringBuilder);

此示例將 Hello World! What a beautiful day. 顯示到控制檯。

AppendFormat 
AppendFormat 方法將文字新增到 StringBuilder 的結尾處，而且實現了 IFormattable 介面，因此可接受格式化部分中描述的標準格式字串。可以使用此方法來自定義變數的格式並將這些值追加到 StringBuilder 的後面。以下示例使用 AppendFormat 方法將一個設定為貨幣值格式的整數值放置到 StringBuilder 的結尾。

[C#] 

int MyInt = 25; 
StringBuilder MyStringBuilder = new StringBuilder("Your total is "); 
MyStringBuilder.AppendFormat("{0:C} ", MyInt); 
Console.WriteLine(MyStringBuilder);

此示例將 Your total is $25.00 顯示到控制檯。

Insert 
Insert 方法將字串或物件新增到當前 StringBuilder 中的指定位置。以下示例使用此方法將一個單詞插入到 StringBuilder 的第六個位置。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); 
MyStringBuilder.Insert(6,"Beautiful "); 
Console.WriteLine(MyStringBuilder);

此示例將 Hello Beautiful World! 顯示到控制檯。

Remove 
可以使用 Remove 方法從當前 StringBuilder 中移除指定數量的字元，移除過程從指定的從零開始的索引處開始。以下示例使用 Remove 方法縮短 StringBuilder。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); 
MyStringBuilder.Remove(5,7); 
Console.WriteLine(MyStringBuilder);

此示例將 Hello 顯示到控制檯。

Replace 
使用 Replace 方法，可以用另一個指定的字元來替換 StringBuilder 物件內的字元。以下示例使用 Replace 方法來搜尋 StringBuilder 物件，查詢所有的感嘆號字元 (!)，並用問號字元 (?) 來替換它們。

[C#] 

StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); 
MyStringBuilder.Replace(’!’, ’?’); 
Console.WriteLine(MyStringBuilder);

此示例將 Hello World? 顯示到控制檯。

AppendLine方法

備註：textBox3.Text = MyStringBuilder.ToString();使用該方法可以轉為string