更新 : 2010 年 12 月
指定した配列内の Unicode 文字の文字列形式をこのインスタンスに追加します。
アセンブリ: mscorlib (mscorlib.dll 内)
Public Function Append ( _ value As Char() _ ) As StringBuilder
public StringBuilder Append( char[] value )
public:
StringBuilder^ Append(
array<wchar_t>^ value
)
member Append : value:char[] -> StringBuilder
パラメーター
- value
- 型: System.Char[]
追加する文字の配列。
| 例外 | 条件 |
|---|---|
| ArgumentOutOfRangeException |
このインスタンスの値を増やすと、MaxCapacity を超えます。 |
このメソッドは、指定した配列内のすべての文字を現在のインスタンスに、value に表示されるときと同じ順番で追加します。 value が null の場合、変更は実行されません。
Append メソッドは、このクラスの既存のインスタンスを変更します。新しいクラス インスタンスは返しません。 このため、次の例に示すように、既存の参照についてメソッドまたはプロパティを呼び出すことができ、戻り値を StringBuilder オブジェクトに割り当てる必要はありません。
Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c } Dim sb As New System.Text.StringBuilder() sb.Append("The characters in the array: ").Append(chars) Console.WriteLine(sb) ' The example displays the following output: ' The characters in the array: aeiou
char[] chars = { 'a', 'e', 'i', 'o', 'u' }; System.Text.StringBuilder sb = new System.Text.StringBuilder(); sb.Append("The characters in the array: ").Append(chars); Console.WriteLine(sb); // The example displays the following output: // The characters in the array: aeiou
このインスタンスの容量は、必要に応じて調整されます。
.NET Framework
サポート対象: 4、3.5、3.0、2.0、1.1、1.0.NET Framework Client Profile
サポート対象: 4、3.5 SP1サポート対象:
Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2
.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
参照
|
日付 |
History |
理由 |
|---|---|---|
|
2010 年 12 月 |
「解説」を追加し、例を削除。 |
カスタマー フィードバック |