StringBuilder.Append StringBuilder.Append StringBuilder.Append StringBuilder.Append Method

定義

指定したオブジェクトの文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified object to this instance.

オーバーロード

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)
Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

指定した 16 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 16-bit unsigned integer to this instance.

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

指定された 32 ビット符号なし整数の文字列表記をこのインスタンスに追加します。 Appends the string representation of a specified 32-bit unsigned integer to this instance.

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

指定した 64 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 64-bit unsigned integer to this instance.

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Unicode 文字の指定した部分配列の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified subarray of Unicode characters to this instance.

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

指定したアドレスで始まる Unicode 文字の配列をこのインスタンスに追加します。 Appends an array of Unicode characters starting at a specified address to this instance.

Append(String) Append(String) Append(String) Append(String)

指定した文字列のコピーをこのインスタンスに追加します。 Appends a copy of the specified string to this instance.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

指定した部分文字列のコピーをこのインスタンスに追加します。 Appends a copy of a specified substring to this instance.

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)
Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Unicode 文字の文字列形式の、指定した数のコピーをこのインスタンスに追加します。 Appends a specified number of copies of the string representation of a Unicode character to this instance.

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

指定した 8 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 8-bit signed integer to this instance.

Append(Single) Append(Single) Append(Single) Append(Single)

指定した単精度浮動小数点数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified single-precision floating-point number to this instance.

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

指定した 8 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 8-bit unsigned integer to this instance.

Append(Object) Append(Object) Append(Object) Append(Object)

指定したオブジェクトの文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified object to this instance.

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

指定した 64 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 64-bit signed integer to this instance.

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

指定した 32 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 32-bit signed integer to this instance.

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

指定した 16 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 16-bit signed integer to this instance.

Append(Double) Append(Double) Append(Double) Append(Double)

指定した倍精度浮動小数点数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified double-precision floating-point number to this instance.

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

指定した 10 進数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified decimal number to this instance.

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

指定した配列内の Unicode 文字の文字列形式をこのインスタンスに追加します。 Appends the string representation of the Unicode characters in a specified array to this instance.

Append(Char) Append(Char) Append(Char) Append(Char)

指定した Char オブジェクトの文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified Char object to this instance.

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)
Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

指定したブール値の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified Boolean value to this instance.

Append(StringBuilder) Append(StringBuilder) Append(StringBuilder) Append(StringBuilder)

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);
member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder
Public Function Append (value As StringBuilder) As StringBuilder
パラメーター
戻り値

Append(UInt16) Append(UInt16) Append(UInt16) Append(UInt16)

重要

この API は CLS 準拠ではありません。

指定した 16 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 16-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);
member this.Append : uint16 -> System.Text.StringBuilder
Public Function Append (value As UShort) As StringBuilder
パラメーター
value
UInt16 UInt16 UInt16 UInt16

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(UInt16)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(UInt16) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

Append(UInt16)メソッドの呼び出し、UInt16.ToString(IFormatProvider)メソッドの文字列表現を取得するvalueします。The Append(UInt16) method calls the UInt16.ToString(IFormatProvider) method to get the string representation of value. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(UInt32) Append(UInt32) Append(UInt32) Append(UInt32)

重要

この API は CLS 準拠ではありません。

指定された 32 ビット符号なし整数の文字列表記をこのインスタンスに追加します。 Appends the string representation of a specified 32-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);
member this.Append : uint32 -> System.Text.StringBuilder
Public Function Append (value As UInteger) As StringBuilder
パラメーター
value
UInt32 UInt32 UInt32 UInt32

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(UInt32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(UInt32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

Append(UInt32)呼び出し、UInt32.ToStringメソッドの文字列表現を取得するvalue現在のカルチャ。The Append(UInt32) calls the UInt32.ToString method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(UInt64) Append(UInt64) Append(UInt64) Append(UInt64)

重要

この API は CLS 準拠ではありません。

指定した 64 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 64-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);
member this.Append : uint64 -> System.Text.StringBuilder
Public Function Append (value As ULong) As StringBuilder
パラメーター
value
UInt64 UInt64 UInt64 UInt64

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(UInt64)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(UInt64) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

Append(UInt64)メソッドの呼び出し、UInt64.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(UInt64) method calls the UInt64.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32) Append(Char[], Int32, Int32)

Unicode 文字の指定した部分配列の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified subarray of Unicode characters to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);
member this.Append : char[] * int * int -> System.Text.StringBuilder
Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder
パラメーター
value
Char[]

文字配列。 A character array.

startIndex
Int32 Int32 Int32 Int32

value 内の開始位置。 The starting position in value.

charCount
Int32 Int32 Int32 Int32

追加する文字数。 The number of characters to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

valuenull であり、startIndexcharCount が 0 以外の値です。 value is null, and startIndex and charCount are not zero.

charCount が 0 未満です。 charCount is less than zero. - または - -or- startIndex が 0 未満です。 startIndex is less than zero. - または - -or- startIndex + charCountvalue の長さを超えています。 startIndex + charCount is greater than the length of value. - または - -or- このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

このメソッドは、指定された文字の範囲を追加します。value現在のインスタンス。This method appends the specified range of characters in value to the current instance. 場合valuenullstartIndexcountはどちらもゼロの変更が行われました。If value is null and startIndex and count are both zero, no changes are made.

Append(Char[], Int32, Int32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Char[], Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' The example displays the following output:
'       The array from positions 0 to 2 contains abc.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Char*, Int32) Append(Char*, Int32) Append(Char*, Int32)

重要

この API は CLS 準拠ではありません。

CLS 準拠の代替
System.Text.StringBuilder.Append(Char[], Int32, Int32)

指定したアドレスで始まる Unicode 文字の配列をこのインスタンスに追加します。 Appends an array of Unicode characters starting at a specified address to this instance.

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
パラメーター
value
Char*

文字の配列を指すポインター。 A pointer to an array of characters.

valueCount
Int32 Int32 Int32 Int32

配列の文字数。 The number of characters in the array.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

valueCount が 0 未満です。 valueCount is less than zero. - または - -or- このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

value が null ポインターです。 value is a null pointer.

注釈

このメソッドは追加valueCountアドレスで始まる文字value現在のインスタンス。This method appends valueCount characters starting at address value to the current instance.

Append(Char*, Int32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Char*, Int32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクト。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(String) Append(String) Append(String) Append(String)

指定した文字列のコピーをこのインスタンスに追加します。 Appends a copy of the specified string to this instance.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (string value);
member this.Append : string -> System.Text.StringBuilder
Public Function Append (value As String) As StringBuilder
パラメーター
value
String String String String

追加する文字列。 The string to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(String)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(String) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

場合valuenull変更は行われません。If value is null, no changes are made.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

指定した部分文字列のコピーをこのインスタンスに追加します。 Appends a copy of a specified substring to this instance.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (string value, int startIndex, int count);
member this.Append : string * int * int -> System.Text.StringBuilder
Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder
パラメーター
value
String String String String

追加する部分文字列を含む文字列。 The string that contains the substring to append.

startIndex
Int32 Int32 Int32 Int32

value 内の部分文字列の開始位置。 The starting position of the substring within value.

count
Int32 Int32 Int32 Int32

value 内の追加する文字数。 The number of characters in value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

valuenull であり、startIndexcount が 0 以外の値です。 value is null, and startIndex and count are not zero.

count が 0 未満です。 count less than zero. - または - -or- startIndex が 0 未満です。 startIndex less than zero. - または - -or- startIndex + countvalue の長さを超えています。 startIndex + count is greater than the length of value. - または - -or- このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

このメソッドは、指定された文字の範囲を追加します。value現在のインスタンス。This method appends the specified range of characters in value to the current instance. 場合valuenullstartIndexcountはどちらもゼロの変更が行われました。If value is null and startIndex and count are both zero, no changes are made.

Append(String, Int32, Int32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(String, Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797      
Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(" to ")
index += length + 1
sb.Append(str, index, str.Length - index)
Console.WriteLine(sb)
' The example displays the following output:
'    First President of the United States: George Washington, from 1789 to 1797      

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32) Append(StringBuilder, Int32, Int32)

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);
member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder
Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder
パラメーター
startIndex
Int32 Int32 Int32 Int32
戻り値

Append(Char, Int32) Append(Char, Int32) Append(Char, Int32) Append(Char, Int32)

Unicode 文字の文字列形式の、指定した数のコピーをこのインスタンスに追加します。 Appends a specified number of copies of the string representation of a Unicode character to this instance.

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);
public System.Text.StringBuilder Append (char value, int repeatCount);
member this.Append : char * int -> System.Text.StringBuilder
Public Function Append (value As Char, repeatCount As Integer) As StringBuilder
パラメーター
value
Char Char Char Char

追加する文字。 The character to append.

repeatCount
Int32 Int32 Int32 Int32

value を追加する回数。 The number of times to append value.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

repeatCount が 0 未満です。 repeatCount is less than zero. - または - -or- このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

メモリが不足しています。 Out of memory.

注釈

Append(Char, Int32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Char, Int32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****$1,346.19*****

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(SByte) Append(SByte) Append(SByte) Append(SByte)

重要

この API は CLS 準拠ではありません。

指定した 8 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 8-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);
member this.Append : sbyte -> System.Text.StringBuilder
Public Function Append (value As SByte) As StringBuilder
パラメーター
value
SByte SByte SByte SByte

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(SByte)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(SByte) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127 
Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127 

Append(SByte)メソッドの呼び出し、SByte.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(SByte) method calls the SByte.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Single) Append(Single) Append(Single) Append(Single)

指定した単精度浮動小数点数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified single-precision floating-point number to this instance.

public:
 System::Text::StringBuilder ^ Append(float value);
public System.Text.StringBuilder Append (float value);
member this.Append : single -> System.Text.StringBuilder
Public Function Append (value As Single) As StringBuilder
パラメーター
value
Single Single Single Single

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Single)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Single) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

Append(Single)メソッドの呼び出し、Single.ToStringメソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Single) method calls the Single.ToString method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Byte) Append(Byte) Append(Byte) Append(Byte)

指定した 8 ビット符号なし整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 8-bit unsigned integer to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Byte value);
public System.Text.StringBuilder Append (byte value);
member this.Append : byte -> System.Text.StringBuilder
Public Function Append (value As Byte) As StringBuilder
パラメーター
value
Byte Byte Byte Byte

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Byte)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Byte) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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

Append(Byte)メソッドの呼び出し、ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Byte) method calls the ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Object) Append(Object) Append(Object) Append(Object)

指定したオブジェクトの文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified object to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (object value);
member this.Append : obj -> System.Text.StringBuilder
Public Function Append (value As Object) As StringBuilder
パラメーター
value
Object Object Object Object

追加するオブジェクト。 The object to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Object)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Object) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates. 定義しますをDogクラスを作成、Dogオブジェクト、およびには 3 つの呼び出し、 Append dog の名前と種類を含む文字列を作成するメソッド。It defines a Dog class, creates a Dog object, and makes three calls to the Append method to create a string that contains the dog's name and breed.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

Append(Object)メソッドの呼び出し、Object.ToStringメソッドの文字列表現を取得するvalueします。The Append(Object) method calls the Object.ToString method to get the string representation of value. 場合valuenullに変更は行われません、StringBuilderオブジェクト。If value is null, no changes are made to the StringBuilder object.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Int64) Append(Int64) Append(Int64) Append(Int64)

指定した 64 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 64-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(long value);
public System.Text.StringBuilder Append (long value);
member this.Append : int64 -> System.Text.StringBuilder
Public Function Append (value As Long) As StringBuilder
パラメーター
value
Int64 Int64 Int64 Int64

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Int64)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Int64) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

Append(Int64)メソッドの呼び出し、Int64.ToString(IFormatProvider)の文字列表現を取得するvalue現在のカルチャ。The Append(Int64) method calls the Int64.ToString(IFormatProvider) to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Int32) Append(Int32) Append(Int32) Append(Int32)

指定した 32 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 32-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(int value);
public System.Text.StringBuilder Append (int value);
member this.Append : int -> System.Text.StringBuilder
Public Function Append (value As Integer) As StringBuilder
パラメーター
value
Int32 Int32 Int32 Int32

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Int32)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Int32) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

Append(Int32)メソッドの呼び出し、Int32.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Int32) method calls the Int32.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Int16) Append(Int16) Append(Int16) Append(Int16)

指定した 16 ビット符号付き整数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified 16-bit signed integer to this instance.

public:
 System::Text::StringBuilder ^ Append(short value);
public System.Text.StringBuilder Append (short value);
member this.Append : int16 -> System.Text.StringBuilder
Public Function Append (value As Short) As StringBuilder
パラメーター
value
Int16 Int16 Int16 Int16

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Int16)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Int16) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

Append(Int16)メソッドの呼び出し、Int16.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Int16) method calls the Int16.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Double) Append(Double) Append(Double) Append(Double)

指定した倍精度浮動小数点数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified double-precision floating-point number to this instance.

public:
 System::Text::StringBuilder ^ Append(double value);
public System.Text.StringBuilder Append (double value);
member this.Append : double -> System.Text.StringBuilder
Public Function Append (value As Double) As StringBuilder
パラメーター
value
Double Double Double Double

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Double)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Double) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

Append(Double)メソッドの呼び出し、Double.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Double) method calls the Double.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Decimal) Append(Decimal) Append(Decimal) Append(Decimal)

指定した 10 進数の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified decimal number to this instance.

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);
public System.Text.StringBuilder Append (decimal value);
member this.Append : decimal -> System.Text.StringBuilder
Public Function Append (value As Decimal) As StringBuilder
パラメーター
value
Decimal Decimal Decimal Decimal

追加する値。 The value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Decimal)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Decimal) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

Append(Decimal)メソッドの呼び出し、Decimal.ToString(IFormatProvider)メソッドの文字列表現を取得するvalue現在のカルチャ。The Append(Decimal) method calls the Decimal.ToString(IFormatProvider) method to get the string representation of value for the current culture. 書式を制御するvalueを呼び出し、AppendFormatメソッド。To control the formatting of value, call the AppendFormat method.

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(Char[]) Append(Char[]) Append(Char[]) Append(Char[])

指定した配列内の Unicode 文字の文字列形式をこのインスタンスに追加します。 Appends the string representation of the Unicode characters in a specified array to this instance.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
public System.Text.StringBuilder Append (char[] value);
member this.Append : char[] -> System.Text.StringBuilder
Public Function Append (value As Char()) As StringBuilder
パラメーター
value
Char[]

追加する文字の配列。 The array of characters to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

このメソッドに表示される現在のインスタンスと同じ順序で指定した配列内のすべての文字を追加valueします。This method appends all the characters in the specified array to the current instance in the same order as they appear in value. 場合valuenull変更は行われません。If value is null, no changes are made.

Append(Char[])メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Char[]) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

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

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

Append(Char) Append(Char) Append(Char) Append(Char)

指定した Char オブジェクトの文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified Char object to this instance.

public:
 System::Text::StringBuilder ^ Append(char value);
public System.Text.StringBuilder Append (char value);
member this.Append : char -> System.Text.StringBuilder
Public Function Append (value As Char) As StringBuilder
パラメーター
value
Char Char Char Char

追加する UTF-16 でエンコードされたコード単位。 The UTF-16-encoded code unit to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Char)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Char) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'      
Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'      

このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>) Append(ReadOnlySpan<Char>)

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);
public System.Text.StringBuilder Append (ReadOnlySpan<char> value);
member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder
パラメーター
戻り値

Append(Boolean) Append(Boolean) Append(Boolean) Append(Boolean)

指定したブール値の文字列形式をこのインスタンスに追加します。 Appends the string representation of a specified Boolean value to this instance.

public:
 System::Text::StringBuilder ^ Append(bool value);
public System.Text.StringBuilder Append (bool value);
member this.Append : bool -> System.Text.StringBuilder
Public Function Append (value As Boolean) As StringBuilder
パラメーター
value
Boolean Boolean Boolean Boolean

追加するブール値。 The Boolean value to append.

戻り値

追加操作が完了した後のこのインスタンスへの参照。 A reference to this instance after the append operation has completed.

例外

このインスタンスの値を増やすと MaxCapacity を超えます。 Enlarging the value of this instance would exceed MaxCapacity.

注釈

Append(Boolean)メソッドは、このクラスの既存のインスタンスを変更します; クラスの新しいインスタンスを返すことはできません。The Append(Boolean) method modifies the existing instance of this class; it does not return a new class instance. このため、上で呼び出せるメソッドまたはプロパティを既存の参照および戻り値を代入する必要はありません、StringBuilderオブジェクトを次の例を示しています。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Append(Boolean)メソッドの呼び出し、Boolean.ToString()メソッドの文字列表現を取得するvalueします。The Append(Boolean) method calls the Boolean.ToString() method to get the string representation of value. このインスタンスの容量は、必要に応じて調整されます。The capacity of this instance is adjusted as needed.

注意 (呼び出し元)

.NET Core と .NET Framework 4.0 および以降のバージョンでインスタンス化するとき、StringBuilderオブジェクトを呼び出すことによって、StringBuilder(Int32, Int32)長さと容量の両方のコンス トラクター、StringBuilderインスタンスは、の値を超えて増加できますそのMaxCapacityプロパティ。 In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 特に呼び出しが発生することができます、Append(String)AppendFormat(String, Object)小さな文字列を追加する方法。 This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

こちらもご覧ください

適用対象