StringBuilder.Append メソッド
指定したオブジェクトの文字列形式をこのインスタンスの末尾に追加します。
オーバーロードの一覧
指定した Boolean 値の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Boolean) As StringBuilder
指定した 8 ビット符号なし整数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Byte) As StringBuilder
指定した Unicode 文字の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Char) As StringBuilder
指定した配列内の Unicode 文字の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Char()) As StringBuilder
指定した 10 進数の文字列形式をこのインスタンスの末尾に追加します。
[Visual Basic] Overloads Public Function Append(Decimal) As StringBuilder
指定した倍精度浮動小数点数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Double) As StringBuilder
指定した 16 ビット符号付き整数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Short) As StringBuilder
指定した 32 ビット符号付き整数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Integer) As StringBuilder
指定した 64 ビット符号付き整数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Long) As StringBuilder
指定したオブジェクトの文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Object) As StringBuilder
指定した 8 ビット符号付き整数の文字列形式をこのインスタンスの末尾に追加します。このメソッドは、CLS と互換性がありません。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(SByte) As StringBuilder
指定した単精度浮動小数点数の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Single) As StringBuilder
指定した文字列のコピーをこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(String) As StringBuilder
指定した 16 ビット符号なし整数の文字列形式をこのインスタンスの末尾に追加します。このメソッドは、CLS と互換性がありません。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(UInt16) As StringBuilder
指定した 32 ビット符号なし整数の文字列形式をこのインスタンスの末尾に追加します。このメソッドは、CLS と互換性がありません。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(UInt32) As StringBuilder
指定した 64 ビット符号なし整数の文字列形式をこのインスタンスの末尾に追加します。このメソッドは、CLS と互換性がありません。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(UInt64) As StringBuilder
Unicode 文字の文字列形式の、指定した数のコピーをこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Char, Integer) As StringBuilder
[JScript] public function Append(Char, int) : StringBuilder;
Unicode 文字の指定した部分配列の文字列形式をこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(Char(), Integer, Integer) As StringBuilder
[C++] public: StringBuilder* Append(__wchar_t __gc[], int, int);
[JScript] public function Append(Char[], int, int) : StringBuilder;
指定した部分文字列のコピーをこのインスタンスの末尾に追加します。
.NET Compact Framework でもサポート。
[Visual Basic] Overloads Public Function Append(String, Integer, Integer) As StringBuilder
[JScript] public function Append(String, int, int) : StringBuilder;
使用例
[Visual Basic, C#, C++] メモ ここでは、Append のオーバーロード形式のうちの 1 つだけについて、使用例を示します。その他の例については、各オーバーロード形式のトピックを参照してください。
' This example demonstrates StringBuilder.Append()
Imports System
Imports System.Text
Class Sample
Public Shared Sub Main()
Dim sep As String = ", "
Dim head As String = "<<<"
Dim tail As Char() = {">"c, ">"c, ">"c}
Dim dash As Char = "-"c
Dim obj As [Object] = 0
Dim xBool As Boolean = True
Dim xByte As Byte = 1
Dim xInt16 As Short = 2
Dim xInt32 As Integer = 3
Dim xInt64 As Long = 4
Dim xDecimal As [Decimal] = 5
Dim xSingle As Single = 6.6F
Dim xDouble As Double = 7.7
' The following types are not CLS-compliant.
' Dim xUInt16 As System.UInt16 = 8
' Dim xUInt32 As System.UInt32 = 9
' Dim xUInt64 As System.UInt64 = 10
' Dim xSByte As System.SByte = - 11
'
Dim sb As New StringBuilder()
sb = sb.Append(head) ' <<<
sb = sb.Append(head, 2, 1) ' <<<<
sb = sb.Append(dash) ' <<<<-
sb = sb.Append(dash).Append(dash) ' <<<<---
sb = sb.Append(xBool).Append(sep)
sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep)
sb = sb.Append(xInt16)
sb = sb.Append(sep)
sb = sb.Append(xInt32)
sb = sb.Append(sep)
sb = sb.Append(xInt64)
sb = sb.Append(sep)
sb = sb.Append(xDecimal).Append(sep)
sb = sb.Append(xSingle).Append(sep).Append(xDouble)
' The following Append methods are not CLS-compliant.
' sb.Append(xUInt16)
' sb.Append(xUInt32)
' sb.Append(xUInt64)
' sb.Append(xSByte)
'
sb = sb.Append(dash, 3) ' ---
sb = sb.Append(tail) ' --->>>
sb = sb.Append(tail, 2, 1) ' --->>>>
Dim str As [String] = sb.ToString()
Console.WriteLine("The appended string is:")
Console.WriteLine(str)
End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'The appended string is:
'<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7--->>>>
'
[C#]
// This example demonstrates StringBuilder.Append()
using System;
using System.Text;
class Sample
{
public static void Main()
{
string sep = ", ";
string head = "<<<";
char[] tail = {'>', '>', '>'};
char dash = '-';
Object obj = 0;
bool xBool = true;
byte xByte = 1;
short xInt16 = 2;
int xInt32 = 3;
long xInt64 = 4;
Decimal xDecimal = 5;
float xSingle = 6.6F;
double xDouble = 7.7;
// The following types are not CLS-compliant.
ushort xUInt16 = 8;
uint xUInt32 = 9;
ulong xUInt64 = 10;
sbyte xSByte = -11;
//
StringBuilder sb = new StringBuilder();
sb = sb.Append(head); // <<<
sb = sb.Append(head, 2, 1); // <<<<
sb = sb.Append(dash); // <<<<-
sb = sb.Append(dash).Append(dash); // <<<<---
sb = sb.Append(xBool).Append(sep);
sb = sb.Append(obj).Append(sep).Append(xByte).Append(sep);
sb = sb.Append(xInt16);
sb = sb.Append(sep);
sb = sb.Append(xInt32);
sb = sb.Append(sep);
sb = sb.Append(xInt64);
sb = sb.Append(sep);
sb = sb.Append(xDecimal).Append(sep);
sb = sb.Append(xSingle).Append(sep).Append(xDouble).Append(sep);
// The following Append methods are not CLS-compliant.
sb = sb.Append(xUInt16).Append(sep);
sb = sb.Append(xUInt32).Append(sep).Append(xUInt64).Append(sep);
sb = sb.Append(xSByte);
//
sb = sb.Append(dash, 3); // ---
sb = sb.Append(tail); // --->>>
sb = sb.Append(tail, 2, 1); // --->>>>
String str = sb.ToString();
Console.WriteLine("The appended string is:");
Console.WriteLine(str);
}
}
/*
This example produces the following results:
The appended string is:
<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>>
*/
[C++]
// This example demonstrates StringBuilder.Append()
#using <mscorlib.dll>
using namespace System;
using namespace System::Text;
int main()
{
String* sep = S", ";
String* head = S"<<<";
Char tail[] = {'>', '>', '>'};
Char dash = '-';
Object* obj = __box(0);
bool xBool = true;
Byte xByte = 1;
short xInt16 = 2;
int xInt32 = 3;
long xInt64 = 4;
Decimal xDecimal = 5;
float xSingle = 6.6F;
double xDouble = 7.7;
// The following types are not CLS-compliant.
UInt16 xUInt16 = 8;
UInt32 xUInt32 = 9;
UInt64 xUInt64 = 10;
SByte xSByte = -11;
//
StringBuilder* sb = new StringBuilder();
sb = sb->Append(head); // <<<
sb = sb->Append(head, 2, 1); // <<<<
sb = sb->Append(dash); // <<<<-
sb = sb->Append(dash)->Append(dash); // <<<<---
sb = sb->Append(xBool)->Append(sep);
sb = sb->Append(obj)->Append(sep)->Append(xByte)->Append(sep);
sb = sb->Append(xInt16);
sb = sb->Append(sep);
sb = sb->Append(xInt32);
sb = sb->Append(sep);
sb = sb->Append(xInt64);
sb = sb->Append(sep);
sb = sb->Append(xDecimal)->Append(sep);
sb = sb->Append(xSingle)->Append(sep)->Append(xDouble)->Append(sep);
// The following Append methods are not CLS-compliant.
sb = sb->Append(xUInt16)->Append(sep);
sb = sb->Append(xUInt32)->Append(sep)->Append(xUInt64)->Append(sep);
sb = sb->Append(xSByte);
//
sb = sb->Append(dash, 3); // ---
sb = sb->Append(tail); // --->>>
sb = sb->Append(tail, 2, 1); // --->>>>
String* str = sb->ToString();
Console::WriteLine(S"The appended string is:");
Console::WriteLine(str);
}
/*
This example produces the following results:
The appended string is:
<<<<---True, 0, 1, 2, 3, 4, 5, 6.6, 7.7, 8, 9, 10, -11--->>>>
*/
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。