StringBuilder Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Sumber:

StringBuilder.cs

Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan.

public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable

public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Warisan

Object

StringBuilder

Penerapan

ISerializable

Contoh

Contoh berikut menunjukkan cara memanggil banyak metode yang ditentukan oleh kelas StringBuilder.

using namespace System;
using namespace System::Text;

int main()
{
    // Create a StringBuilder that expects to hold 50 characters.
    // Initialize the StringBuilder with "ABC".
    StringBuilder^ sb = gcnew StringBuilder("ABC", 50);

    // Append three characters (D, E, and F) to the end of the
    // StringBuilder.
    sb->Append(gcnew array<Char>{'D', 'E', 'F'});

    // Append a format string to the end of the StringBuilder.
    sb->AppendFormat("GHI{0}{1}", (Char)'J', (Char)'k');

    // Display the number of characters in the StringBuilder
    // and its string.
    Console::WriteLine("{0} chars: {1}", sb->Length, sb->ToString());

    // Insert a string at the beginning of the StringBuilder.
    sb->Insert(0, "Alphabet: ");

    // Replace all lowercase k's with uppercase K's.
    sb->Replace('k', 'K');

    // Display the number of characters in the StringBuilder
    // and its string.
    Console::WriteLine("{0} chars: {1}", sb->Length, sb->ToString());
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

using System;
using System.Text;

public sealed class App
{
    static void Main()
    {
        // Create a StringBuilder that expects to hold 50 characters.
        // Initialize the StringBuilder with "ABC".
        StringBuilder sb = new StringBuilder("ABC", 50);

        // Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(new char[] { 'D', 'E', 'F' });

        // Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", 'J', 'k');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());

        // Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ");

        // Replace all lowercase k's with uppercase K's.
        sb.Replace('k', 'K');

        // Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString());
    }
}

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

open System.Text

// Create a StringBuilder that expects to hold 50 characters.
// Initialize the StringBuilder with "ABC".
let sb = StringBuilder("ABC", 50)

// Append three characters (D, E, and F) to the end of the StringBuilder.
sb.Append [| 'D'; 'E'; 'F' |] |> ignore

// Append a format string to the end of the StringBuilder.
sb.AppendFormat("GHI{0}{1}", 'J', 'k') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// Insert a string at the beginning of the StringBuilder.
sb.Insert(0, "Alphabet: ") |> ignore

// Replace all lowercase k's with uppercase K's.
sb.Replace('k', 'K') |> ignore

// Display the number of characters in the StringBuilder and its string.
printfn $"{sb.Length} chars: {sb}"

// This code produces the following output.
//
// 11 chars: ABCDEFGHIJk
// 21 chars: Alphabet: ABCDEFGHIJK

Imports System.Text

Public Module App 
    Public Sub Main() 
        ' Create a StringBuilder that expects to hold 50 characters.
        ' Initialize the StringBuilder with "ABC".
        Dim sb As New StringBuilder("ABC", 50)

        ' Append three characters (D, E, and F) to the end of the StringBuilder.
        sb.Append(New Char() {"D"c, "E"c, "F"c})

        ' Append a format string to the end of the StringBuilder.
        sb.AppendFormat("GHI{0}{1}", "J"c, "k"c)

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())

        ' Insert a string at the beginning of the StringBuilder.
        sb.Insert(0, "Alphabet: ")

        ' Replace all lowercase k's with uppercase K's.
        sb.Replace("k", "K")

        ' Display the number of characters in the StringBuilder and its string.
        Console.WriteLine("{0} chars: {1}", sb.Length, sb.ToString())
    End Sub
End Module

' This code produces the following output.
'
' 11 chars: ABCDEFGHIJk
' 21 chars: Alphabet: ABCDEFGHIJK

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat keterangan API Tambahan untuk StringBuilder.

Catatan Bagi Pemanggil

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

Konstruktor

StringBuilder()	Menginisialisasi instans baru kelas StringBuilder.
StringBuilder(Int32)	Menginisialisasi instans baru kelas StringBuilder menggunakan kapasitas yang ditentukan.
StringBuilder(Int32, Int32)	Menginisialisasi instans baru kelas StringBuilder yang dimulai dengan kapasitas tertentu dan dapat tumbuh hingga maksimum yang ditentukan.
StringBuilder(String)	Menginisialisasi instans baru kelas StringBuilder menggunakan string yang ditentukan.
StringBuilder(String, Int32)	Menginisialisasi instans baru kelas StringBuilder menggunakan string dan kapasitas yang ditentukan.
StringBuilder(String, Int32, Int32, Int32)	Menginisialisasi instans baru kelas StringBuilder dari substring dan kapasitas yang ditentukan.

Properti

Capacity	Mendapatkan atau mengatur jumlah maksimum karakter yang dapat dimuat dalam memori yang dialokasikan oleh instans saat ini.
Chars[Int32]	Mendapatkan atau mengatur karakter pada posisi karakter yang ditentukan dalam instans ini.
Length	Mendapatkan atau mengatur panjang objek StringBuilder saat ini.
MaxCapacity	Mendapatkan kapasitas maksimum instans ini.

Metode

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 Char tertentu ke instans ini.
Append(Char*, Int32)	Menambahkan array karakter Unicode mulai dari alamat tertentu ke instans ini.
Append(Char, Int32)	Menambahkan sejumlah salinan tertentu dari representasi string karakter Unicode ke instans ini.
Append(Char[])	Menambahkan representasi string dari karakter Unicode dalam array tertentu ke instans ini.
Append(Char[], Int32, Int32)	Menambahkan representasi string dari subarray karakter Unicode tertentu 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(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan ke instans ini menggunakan format yang ditentukan.
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(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(Single)	Menambahkan representasi string dari angka floating-point presisi tunggal yang ditentukan ke instans ini.
Append(String)	Menambahkan salinan string yang ditentukan ke instans ini.
Append(String, Int32, Int32)	Menambahkan salinan substring tertentu ke instans ini.
Append(StringBuilder)	Menambahkan representasi string dari pembangun string tertentu ke instans ini.
Append(StringBuilder, Int32, Int32)	Menambahkan salinan substring dalam pembangun 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(UInt64)	Menambahkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit tertentu ke instans ini.
AppendFormat(IFormatProvider, CompositeFormat, Object[])	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu argumen menggunakan penyedia format tertentu.
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu argumen menggunakan penyedia format tertentu.
AppendFormat(IFormatProvider, String, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari satu argumen menggunakan penyedia format tertentu.
AppendFormat(IFormatProvider, String, Object, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu dari dua argumen menggunakan penyedia format tertentu.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu dari tiga argumen menggunakan penyedia format tertentu.
AppendFormat(IFormatProvider, String, Object[])	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string argumen yang sesuai dalam array parameter menggunakan penyedia format tertentu.
AppendFormat(String, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari satu argumen.
AppendFormat(String, Object, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu dari dua argumen.
AppendFormat(String, Object, Object, Object)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu dari tiga argumen.
AppendFormat(String, Object[])	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari argumen yang sesuai dalam array parameter.
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu argumen menggunakan penyedia format tertentu.
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu argumen menggunakan penyedia format tertentu.
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	Menambahkan string yang dikembalikan dengan memproses string format komposit, yang berisi nol atau lebih item format, ke instans ini. Setiap item format digantikan oleh representasi string dari salah satu argumen menggunakan penyedia format tertentu.
AppendJoin(Char, Object[])	Menggabungkan representasi string elemen dalam array objek yang disediakan, menggunakan pemisah karakter yang ditentukan antara setiap anggota, lalu menambahkan hasilnya ke instans pembangun string saat ini.
AppendJoin(Char, String[])	Menggabungkan string array yang disediakan, menggunakan pemisah karakter yang ditentukan di antara setiap string, lalu menambahkan hasilnya ke instans pembangun string saat ini.
AppendJoin(String, Object[])	Menggabungkan representasi string elemen dalam array objek yang disediakan, menggunakan pemisah yang ditentukan antara setiap anggota, lalu menambahkan hasilnya ke instans pembangun string saat ini.
AppendJoin(String, String[])	Menggabungkan string array yang disediakan, menggunakan pemisah yang ditentukan di antara setiap string, lalu menambahkan hasilnya ke instans pembangun string saat ini.
AppendJoin<T>(Char, IEnumerable<T>)	Menggabungkan dan menambahkan anggota koleksi, menggunakan pemisah karakter yang ditentukan antara setiap anggota.
AppendJoin<T>(String, IEnumerable<T>)	Menggabungkan dan menambahkan anggota koleksi, menggunakan pemisah yang ditentukan antara setiap anggota.
AppendLine()	Menambahkan terminator baris default ke akhir objek StringBuilder saat ini.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan menggunakan format yang ditentukan, diikuti oleh terminator baris default, ke akhir objek StringBuilder saat ini.
AppendLine(String)	Menambahkan salinan string yang ditentukan diikuti oleh terminator baris default ke akhir objek StringBuilder saat ini.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan diikuti oleh terminator baris default ke akhir objek StringBuilder saat ini.
Clear()	Menghapus semua karakter dari instans StringBuilder saat ini.
CopyTo(Int32, Char[], Int32, Int32)	Menyalin karakter dari segmen tertentu dari instans ini ke segmen tertentu dari array Char tujuan.
CopyTo(Int32, Span<Char>, Int32)	Menyalin karakter dari segmen tertentu dari instans ini ke rentang Char tujuan.
EnsureCapacity(Int32)	Memastikan bahwa kapasitas instans StringBuilder ini setidaknya merupakan nilai yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Equals(ReadOnlySpan<Char>)	Mengembalikan nilai yang menunjukkan apakah karakter dalam instans ini sama dengan karakter dalam rentang karakter baca-saja yang ditentukan.
Equals(StringBuilder)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu.
GetChunks()	Mengembalikan objek yang dapat digunakan untuk melakukan iterasi melalui potongan karakter yang diwakili dalam ReadOnlyMemory<Char> yang dibuat dari instans StringBuilder ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Insert(Int32, Boolean)	Menyisipkan representasi string dari nilai Boolean ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Byte)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char)	Menyisipkan representasi string dari karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char[])	Menyisipkan representasi string dari array karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Char[], Int32, Int32)	Menyisipkan representasi string dari subarray karakter Unicode tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Decimal)	Menyisipkan representasi string dari angka desimal ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Double)	Menyisipkan representasi string dari angka floating-point presisi ganda ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int16)	Menyisipkan representasi string dari bilangan bulat yang ditandatangani 16-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int32)	Menyisipkan representasi string dari bilangan bulat bertanda tangan 32-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int64)	Menyisipkan representasi string dari bilangan bulat bertanda tangan 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Object)	Menyisipkan representasi string objek ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, ReadOnlySpan<Char>)	Menyisipkan urutan karakter ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, SByte)	Menyisipkan representasi string dari bilangan bulat bertanda tangan 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Single)	Menyisipkan representasi string dari angka titik mengambang presisi tunggal ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, String)	Menyisipkan string ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, String, Int32)	Menyisipkan satu atau beberapa salinan string tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt16)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 16-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt32)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 32-bit ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, UInt64)	Menyisipkan representasi string dari bilangan bulat yang tidak ditandatangani 64-bit ke dalam instans ini pada posisi karakter yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Remove(Int32, Int32)	Menghapus rentang karakter yang ditentukan dari instans ini.
Replace(Char, Char)	Mengganti semua kemunculan karakter tertentu dalam instans ini dengan karakter lain yang ditentukan.
Replace(Char, Char, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan karakter tertentu dengan karakter lain yang ditentukan.
Replace(String, String)	Mengganti semua kemunculan string tertentu dalam instans ini dengan string lain yang ditentukan.
Replace(String, String, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan string tertentu dengan string lain yang ditentukan.
ToString()	Mengonversi nilai instans ini menjadi String.
ToString(Int32, Int32)	Mengonversi nilai substring instans ini menjadi String.

Implementasi Antarmuka Eksplisit

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Mengisi objek SerializationInfo dengan data yang diperlukan untuk mendeserialisasi objek StringBuilder saat ini.

Metode Ekstensi

Append(StringBuilder, StringSegment)	Tambahkan StringSegment yang diberikan ke StringBuilder.
AppendRedacted(StringBuilder, Redactor, ReadOnlySpan<Char>)	Meredaksi data yang berpotensi sensitif dan menambahkannya ke instans StringBuilder.
AppendRedacted(StringBuilder, Redactor, String)	Meredaksi data yang berpotensi sensitif dan menambahkannya ke instans StringBuilder.

Lihat juga

• String