String對象是不可改變的。每次使用System.String類中的方法之一時,都要在記憶體中建立一個新的字串對象,這就需要為該新對象分配新的空間。在需要對字串執行重複修改的情況下,與建立新的String對象相關的系統開銷可能會非常昂貴。如果要修改字串而不建立新的對象,則可以使用System.Text.StringBuilder 類。
例如,當在一個迴圈中將許多字串串連在一起時,使用StringBuilder類可以提升效能。
通過用一個重載的建構函式方法初始設定變數,可以建立StringBuilder類的新執行個體,如下例
StringBuilder MyStringBuilder = new StringBuilder( "Hello World!" );
設定容量和長度
雖然StringBuilder對象是動態對象,允許擴充它所封裝的字串中字元的數量,但是您可以為它可容納的最大字元數指定一個值。此值稱為該對象的容量,不應將它與當前StringBuilder對象容納的字串長度混淆在一起。例如,可以建立StringBuilder類的帶有字串“Hello”(長度為5)的一個新執行個體,同時可以指定該對象的最大容量為25。當修改StringBuilder時,在達到容量之前,它不會為其自己重新分配空間。當達到容量時,將自動分配新的空間且容量翻倍。可以使用重載的建構函式之一來指定StringBuilder類的容量。以下程式碼範例指定可以將MyStringBuilder對象擴充到最大25個空白。
StringBuilder MyStringBuilder = new StringBuilder( "Hello World!" , 25 );
另外,可以使用讀/寫Capacity屬性來設定對象的最大長度。以下程式碼範例使用Capacity屬性來定義對象的最大長度。
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”,然後將一些文本追加到該對象的結尾處。將根據需要自動分配空間。
StringBuilderMyStringBuilder = newStringBuilder("Hello World!");
MyStringBuilder.Append("What a beautiful day.");
Console.WriteLine(MyStringBuilder);
此樣本將“Hello World!What a beautiful day.”顯示到控制台。
AppendFormat
AppendFormat方法將文本添加到StringBuilder的結尾處,而且實現了IFormattable介面,因此可接受格式化部分中描述的標準格式字串。可以使用此方法來自訂變數的格式並將這些值追加到StringBuilder的後面。以下樣本使用AppendFormat方法將一個設定為貨幣值格式的整數值放置到StringBuilder的結尾。
intMyInt = 25;
StringBuilderMyStringBuilder = newStringBuilder("Your total is");
MyStringBuilder.AppendFormat("{0:C}", MyInt);
Console.WriteLine(MyStringBuilder);
此樣本將“Your total is $25.00”顯示到控制台。
Insert
Insert方法將字串或對象添加到當前StringBuilder中的指定位置。以下樣本使用此方法將一個單詞插入到StringBuilder的第六個位置。
StringBuilderMyStringBuilder = newStringBuilder("Hello World!");
MyStringBuilder.Insert(6, "Beautiful");
Console.WriteLine(MyStringBuilder);
此樣本將“Hello Beautiful World!”顯示到控制台。
Remove
可以使用Remove方法從當前StringBuilder中移除指定數量的字元,移除過程從指定的從零開始的索引處開始。以下樣本使用Remove方法縮短StringBuilder。
StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); MyStringBuilder.Remove(5, 7); Console.WriteLine(MyStringBuilder);
此樣本將“Hello”顯示到控制台。
Replace
使用Replace方法,可以用另一個指定的字元來替換StringBuilder對象內的字元。以下樣本使用Replace方法來搜尋StringBuilder對象,尋找所有的驚嘆號字元(!),並用問號字元(?)來替換它們。
StringBuilder MyStringBuilder = new StringBuilder("Hello World!"); MyStringBuilder.Replace('!', '?'); Console.WriteLine(MyStringBuilder);