StringBuilder.Append メソッド (Byte) (System.Text)

ビューの切り替え:
スクリプトなし
.NET Framework クラス ライブラリ
StringBuilder.Append メソッド (Byte)
この記事は翻訳者によって翻訳されたものです。 このページおよび元の英語コンテンツを同時に表示させるには、[ライトウェイト] に切り替えます。

更新 : 2010 年 12 月

指定した 8 ビット符号なし整数の文字列形式をこのインスタンスに追加します。

名前空間:  System.Text
アセンブリ:  mscorlib (mscorlib.dll 内)
構文

Visual Basic
Public Function Append ( _
	value As Byte _
) As StringBuilder
C#
public StringBuilder Append(
	byte value
)
Visual C++
public:
StringBuilder^ Append(
	unsigned char value
)
F#
member Append : 
        value:byte -> StringBuilder 

パラメーター

value
型: System.Byte
追加する値。

戻り値

型: System.Text.StringBuilder
追加操作が完了した後のこのインスタンスへの参照。
例外

例外 条件
ArgumentOutOfRangeException

このインスタンスの値を増やすと、MaxCapacity を超えます。

解説

Append メソッドは、このクラスの既存のインスタンスを変更します。新しいクラス インスタンスは返しません。 このため、次の例に示すように、既存の参照についてメソッドまたはプロパティを呼び出すことができ、戻り値を StringBuilder オブジェクトに割り当てる必要はありません。

Visual Basic

Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253      


C#

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253      


Append メソッドは、ToString メソッドを呼び出して、現在のカルチャの value の文字列形式を取得します。 value の書式設定を制御するために、AppendFormat メソッドを呼び出します。

このインスタンスの容量は、必要に応じて調整されます。

バージョン情報

.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 月

「解説」を追加し、例を削除。

カスタマー フィードバック