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 StringBuilder kelas .

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

Konstruktor

StringBuilder()	Menginisialisasi instans baru kelas StringBuilder.
StringBuilder(Int32)	Menginisialisasi instans StringBuilder baru kelas menggunakan kapasitas yang ditentukan.
StringBuilder(Int32, Int32)	Menginisialisasi instans StringBuilder baru kelas yang dimulai dengan kapasitas tertentu dan dapat tumbuh hingga maksimum yang ditentukan.
StringBuilder(String)	Menginisialisasi instans StringBuilder baru kelas menggunakan string yang ditentukan.
StringBuilder(String, Int32)	Menginisialisasi instans StringBuilder baru kelas menggunakan string dan kapasitas yang ditentukan.
StringBuilder(String, Int32, Int32, Int32)	Menginisialisasi instans StringBuilder baru kelas 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 saat ini StringBuilder .
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 tertentu Char ke instans ini.
Append(Char*, Int32)	Menambahkan array karakter Unicode yang dimulai dari alamat tertentu ke instans ini.
Append(Char, Int32)	Menambahkan sejumlah salinan tertentu dari representasi string dari karakter Unicode ke instans ini.
Append(Char[])	Menambahkan representasi string 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 penyusun string tertentu ke instans ini.
Append(StringBuilder, Int32, Int32)	Menambahkan salinan substring dalam 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(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 terkait 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 penyusun 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 penyusun 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 di 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 saat ini StringBuilder .
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan menggunakan format yang ditentukan, diikuti dengan terminator baris default, ke akhir objek StringBuilder saat ini.
AppendLine(String)	Menambahkan salinan string yang ditentukan diikuti oleh terminator baris default ke akhir objek saat ini StringBuilder .
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 saat ini StringBuilder .
CopyTo(Int32, Char[], Int32, Int32)	Menyalin karakter dari segmen tertentu dari instans ini ke segmen tertentu dari array tujuan Char .
CopyTo(Int32, Span<Char>, Int32)	Menyalin karakter dari segmen tertentu dari instans ini ke rentang tujuan Char .
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 mengulangi potongan karakter yang diwakili dalam yang ReadOnlyMemory<Char> dibuat dari instans ini StringBuilder .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type 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 bertanda 16-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int32)	Menyisipkan representasi string dari bilangan bulat bertanda 32-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Int64)	Menyisipkan representasi string bilangan bulat bertanda 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>)	Sisipkan urutan karakter ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, SByte)	Menyisipkan representasi string dari bilangan bulat bertanda 8-bit tertentu ke dalam instans ini pada posisi karakter yang ditentukan.
Insert(Int32, Single)	Menyisipkan representasi string dari angka titik floating 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 saat ini Object. (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)	Mengganti, 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)	Mengganti, 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 dengan data yang SerializationInfo diperlukan untuk mendeserialisasi objek saat ini StringBuilder .

Lihat juga

• String