StringBuilder.Append Metode

Referensi

Definisi

Ruang nama:: System.Text

Rakitan:: System.Runtime.dll

Rakitan:: netstandard.dll

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan representasi string dari objek tertentu ke instans ini.

Overload

Append(StringBuilder)	Menambahkan representasi string dari penyusun string tertentu ke instans ini.
Append(StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan ke instans ini.
Append(UInt16)	Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 16-bit tertentu ke instans ini.
Append(UInt32)	Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 32-bit tertentu ke instans ini.
Append(Char, Int32)	Menambahkan sejumlah salinan tertentu dari representasi string dari karakter Unicode ke instans ini.
Append(Char[], Int32, Int32)	Menambahkan representasi string dari subarray karakter Unicode tertentu ke instans ini.
Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan ke instans ini menggunakan format yang ditentukan.
Append(String)	Menambahkan salinan string yang ditentukan ke instans ini.
Append(String, Int32, Int32)	Menambahkan salinan substring tertentu ke instans ini.
Append(StringBuilder, Int32, Int32)	Menambahkan salinan substring dalam penyusun string tertentu ke instans ini.
Append(Char*, Int32)	Menambahkan array karakter Unicode yang dimulai dari alamat tertentu ke instans ini.
Append(Single)	Menambahkan representasi string dari angka floating-point presisi tunggal yang ditentukan ke instans ini.
Append(UInt64)	Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit tertentu ke instans ini.
Append(ReadOnlySpan<Char>)	Menambahkan representasi string dari rentang karakter baca-saja tertentu ke instans ini.
Append(SByte)	Menambahkan representasi string dari bilangan bulat bertanda tangan 8-bit tertentu ke instans ini.
Append(Boolean)	Menambahkan representasi string dari nilai Boolean tertentu ke instans ini.
Append(Byte)	Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 8-bit tertentu ke instans ini.
Append(Char)	Menambahkan representasi string dari objek tertentu Char ke instans ini.
Append(Decimal)	Menambahkan representasi string dari angka desimal tertentu ke instans ini.
Append(Double)	Menambahkan representasi string dari angka floating-point presisi ganda yang ditentukan ke instans ini.
Append(Char[])	Menambahkan representasi string karakter Unicode dalam array tertentu ke instans ini.
Append(Int16)	Menambahkan representasi string dari bilangan bulat bertanda tangan 16-bit tertentu ke instans ini.
Append(Int32)	Menambahkan representasi string dari bilangan bulat bertanda tangan 32-bit tertentu ke instans ini.
Append(Int64)	Menambahkan representasi string dari bilangan bulat bertanda tangan 64-bit tertentu ke instans ini.
Append(Object)	Menambahkan representasi string dari objek tertentu ke instans ini.
Append(ReadOnlyMemory<Char>)	Menambahkan representasi string dari wilayah memori karakter baca-saja tertentu ke instans ini.

Append(StringBuilder)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari penyusun string tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);

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

Parameter

value: StringBuilder

Penyusun string untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Append(StringBuilder+AppendInterpolatedStringHandler)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan string terinterpolasi yang ditentukan ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

handler: StringBuilder.AppendInterpolatedStringHandler

String terinterpolasi untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Append(UInt16)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 16-bit tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);

[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder

Public Function Append (value As UShort) As StringBuilder

Parameter

value: UInt16

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(UInt16) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{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

Metode Append(UInt16) ini memanggil UInt16.ToString(IFormatProvider) metode untuk mendapatkan representasi string dari value. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Di .NET Core dan di .NET Framework 4.0 dan versi yang lebih baru, ketika Anda membuat StringBuilder instans objek dengan memanggil StringBuilder(Int32, Int32) konstruktor, panjang dan kapasitas StringBuilder instans dapat tumbuh di luar nilai propertinyaMaxCapacity. Ini dapat terjadi terutama ketika Anda memanggil Append(String) metode dan AppendFormat(String, Object) untuk menambahkan string kecil.

Lihat juga

UInt16

Berlaku untuk

Append(UInt32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 32-bit tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);

[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder

Public Function Append (value As UInteger) As StringBuilder

Parameter

value: UInt32

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(UInt32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{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

memanggil Append(UInt32)UInt32.ToString metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

UInt32

Berlaku untuk

Append(Char, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan sejumlah salinan tertentu dari representasi string dari karakter Unicode ke instans ini.

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

Parameter

value: Char

Karakter untuk ditambahkan.

repeatCount: Int32

Jumlah waktu untuk menambahkan value.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

repeatCount kurang dari nol.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

OutOfMemoryException

Kehabisan memori.

Keterangan

Metode memodifikasi Append(Char, Int32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{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*****

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Char

Berlaku untuk

Append(Char[], Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari subarray karakter Unicode tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);

public System.Text.StringBuilder Append (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

Parameter

value: Char[]

Array karakter.

startIndex: Int32

Posisi awal di value.

charCount: Int32

Jumlah karakter yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentNullException

value adalah null, dan startIndex dan charCount bukan nol.

ArgumentOutOfRangeException

charCount kurang dari nol.

-atau-

startIndex kurang dari nol.

-atau-

startIndex + charCount lebih besar dari panjang value.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode ini menambahkan rentang karakter yang ditentukan ke value instans saat ini. Jika value adalah null dan startIndex dan count keduanya nol, tidak ada perubahan yang dilakukan.

Metode memodifikasi Append(Char[], Int32, Int32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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.

let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{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.

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Char

Berlaku untuk

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan string terinterpolasi yang ditentukan ke instans ini menggunakan format yang ditentukan.

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

provider: IFormatProvider

Objek yang memasok informasi pemformatan khusus budaya.

handler: StringBuilder.AppendInterpolatedStringHandler

String terinterpolasi untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Append(String)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan salinan string yang ditentukan ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);

public System.Text.StringBuilder Append (string value);

public System.Text.StringBuilder Append (string? value);

member this.Append : string -> System.Text.StringBuilder

Public Function Append (value As String) As StringBuilder

Parameter

value: String

String yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(String) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// 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.

Jika value adalah null, tidak ada perubahan yang dilakukan.

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Di .NET Core dan dalam versi .NET Framework 4.0 dan yang lebih baru, ketika Anda membuat StringBuilder instans objek dengan memanggil StringBuilder(Int32, Int32) konstruktor, panjang dan kapasitas StringBuilder instans dapat tumbuh di luar nilai propertinyaMaxCapacity. Ini dapat terjadi terutama ketika Anda memanggil Append(String) metode dan AppendFormat(String, Object) untuk menambahkan string kecil.

Lihat juga

String

Berlaku untuk

Append(String, Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan salinan substring tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);

public System.Text.StringBuilder Append (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

Parameter

value: String

String yang berisi substring yang akan ditambahkan.

startIndex: Int32

Posisi awal substring dalam value.

count: Int32

Jumlah karakter untuk value ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentNullException

value adalah null, dan startIndex dan count bukan nol.

ArgumentOutOfRangeException

count kurang dari nol.

-atau-

startIndex kurang dari nol.

-atau-

startIndex + count lebih besar dari panjang value.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode ini menambahkan rentang karakter yang ditentukan ke value instans saat ini. Jika value adalah null dan startIndex dan count keduanya nol, tidak ada perubahan yang dilakukan.

Metode memodifikasi Append(String, Int32, Int32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{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

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

String

Berlaku untuk

Append(StringBuilder, Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan salinan substring dalam penyusun string tertentu ke instans ini.

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

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

Parameter

value: StringBuilder

Penyusun string yang berisi substring untuk ditambahkan.

startIndex: Int32

Posisi awal substring dalam value.

count: Int32

Jumlah karakter untuk value ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Append(Char*, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Alternatif kompatibel CLS: System.Text.StringBuilder.Append(Char[], Int32, Int32)

Menambahkan array karakter Unicode yang dimulai dari alamat tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Parameter

value: Char*

Penunjuk ke array karakter.

valueCount: Int32

Jumlah karakter dalam array.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Atribut: CLSCompliantAttribute SecurityCriticalAttribute

Pengecualian

ArgumentOutOfRangeException

valueCount kurang dari nol.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

NullReferenceException

value adalah penunjuk null.

Keterangan

Metode ini menambahkan valueCount karakter yang dimulai dari alamat value ke instans saat ini.

Metode memodifikasi Append(Char*, Int32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek.

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Berlaku untuk

Append(Single)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari angka floating-point presisi tunggal tertentu ke instans ini.

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

Parameter

value: Single

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Single) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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*****

Metode Append(Single) ini memanggil Single.ToString metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Single

Berlaku untuk

Append(UInt64)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);

[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder

Public Function Append (value As ULong) As StringBuilder

Parameter

value: UInt64

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(UInt64) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai kembali ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{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

Metode Append(UInt64) ini memanggil UInt64.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

UInt64

Berlaku untuk

Append(ReadOnlySpan<Char>)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari rentang karakter baca-saja tertentu ke instans ini.

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

Parameter

value: ReadOnlySpan<Char>

Rentang karakter baca-saja untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Append(SByte)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan representasi string dari bilangan bulat bertanda tangan 8-bit tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::SByte value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);

[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder

Public Function Append (value As SByte) As StringBuilder

Parameter

value: SByte

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Atribut: CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(SByte) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{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

Metode ini Append(SByte) memanggil SByte.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

SByte

Berlaku untuk

Append(Boolean)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari nilai Boolean tertentu ke instans ini.

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

Parameter

value: Boolean

Nilai Boolean untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Boolean) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// 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.

Metode Append(Boolean) ini memanggil Boolean.ToString() metode untuk mendapatkan representasi string dari value. Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Boolean

Berlaku untuk

Append(Byte)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 8-bit tertentu ke instans ini.

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

Parameter

value: Byte

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Byte) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// 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

Metode ini Append(Byte) memanggil ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Byte

Berlaku untuk

Append(Char)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari objek tertentu Char ke instans ini.

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

Parameter

value: Char

Unit kode yang dikodekan UTF-16 untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Char) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {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'  '.'

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Char

Berlaku untuk

Append(Decimal)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari angka desimal tertentu ke instans ini.

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

Parameter

value: Decimal

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Decimal) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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*****

Metode ini Append(Decimal) memanggil Decimal.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Decimal

Berlaku untuk

Append(Double)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari angka floating-point presisi ganda yang ditentukan ke instans ini.

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

Parameter

value: Double

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Double) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{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*****

Metode ini Append(Double) memanggil Double.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Double

Berlaku untuk

Append(Char[])

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string karakter Unicode dalam array tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);

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

Parameter

value: Char[]

Array karakter untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode ini menambahkan semua karakter dalam array yang ditentukan ke instans saat ini dalam urutan yang sama seperti yang muncul di value. Jika value adalah null, tidak ada perubahan yang dilakukan.

Metode memodifikasi Append(Char[]) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{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

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Berlaku untuk

Append(Int16)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari bilangan bulat bertanda tangan 16-bit tertentu ke instans ini.

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

Parameter

value: Int16

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Int16) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{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

Metode ini Append(Int16) memanggil Int16.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int16

Berlaku untuk

Append(Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari bilangan bulat bertanda tangan 32-bit tertentu ke instans ini.

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

Parameter

value: Int32

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Int32) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{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

Metode ini Append(Int32) memanggil Int32.ToString(IFormatProvider) metode untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int32

Berlaku untuk

Append(Int64)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari bilangan bulat bertanda tangan 64-bit tertentu ke instans ini.

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

Parameter

value: Int64

Nilai yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Int64) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut.

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

let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{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

Metode ini Append(Int64) memanggil Int64.ToString(IFormatProvider) untuk mendapatkan representasi string untuk value budaya saat ini. Untuk mengontrol pemformatan value, panggil AppendFormat metode .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Int64

Berlaku untuk

Append(Object)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari objek tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);

public System.Text.StringBuilder Append (object value);

public System.Text.StringBuilder Append (object? value);

member this.Append : obj -> System.Text.StringBuilder

Public Function Append (value As Object) As StringBuilder

Parameter

value: Object

Objek yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode memodifikasi Append(Object) instans kelas ini yang ada; tidak mengembalikan instans kelas baru. Karena itu, Anda dapat memanggil metode atau properti pada referensi yang ada dan Anda tidak perlu menetapkan nilai yang dikembalikan ke StringBuilder objek, seperti yang diilustrasikan contoh berikut. Ini mendefinisikan Dog kelas, membuat Dog objek, dan melakukan tiga panggilan ke Append metode untuk membuat string yang berisi nama dan ras anjing.

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

open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

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

Metode Append(Object) ini memanggil Object.ToString metode untuk mendapatkan representasi string dari value. Jika value adalah null, tidak ada perubahan yang dilakukan pada StringBuilder objek .

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Lihat juga

Object

Berlaku untuk

Append(ReadOnlyMemory<Char>)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menambahkan representasi string dari wilayah memori karakter baca-saja tertentu ke instans ini.

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);

public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);

member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder

Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Parameter

value: ReadOnlyMemory<Char>

Wilayah memori karakter baca-saja untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampan selesai.

Berlaku untuk

Bagikan melalui

StringBuilder.Append Metode

Definisi

Overload

Append(StringBuilder)

Parameter

Mengembalikan

Berlaku untuk

Append(StringBuilder+AppendInterpolatedStringHandler)

Parameter

Mengembalikan

Berlaku untuk

Append(UInt16)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(UInt32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(Char, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(Char[], Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parameter

Mengembalikan

Berlaku untuk

Append(String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(String, Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Append(StringBuilder, Int32, Int32)

Parameter

Mengembalikan

Berlaku untuk

Append(Char*, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Berlaku untuk

Append(Single)

Parameter

Mengembalikan

Pengecualian

Keterangan