StringBuilder Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

mscorlib.dll

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

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

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Warisan

Object

StringBuilder

Atribut

SerializableAttribute ComVisibleAttribute

Penerapan

ISerializable

Contoh

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

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 Komentar API tambahan untuk StringBuilder.

Catatan Bagi Pemanggil

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

Konstruktor

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

Properti

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

Nama	Deskripsi
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, Int32)	Menambahkan sejumlah salinan tertentu dari representasi string karakter Unicode ke instans ini.
Append(Char)	Menambahkan representasi string dari objek tertentu Char ke instans ini.
Append(Char[], Int32, Int32)	Menambahkan representasi string dari subarray karakter Unicode tertentu ke instans ini.
Append(Char[])	Menambahkan representasi string dari karakter Unicode dalam array tertentu ke instans ini.
Append(Char*, Int32)	Menambahkan array karakter Unicode mulai dari alamat 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(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(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, Int32, Int32)	Menambahkan salinan substring tertentu ke instans ini.
Append(String)	Menambahkan salinan string 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, 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, 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)	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[])	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, 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, 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)	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[])	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.
AppendLine()	Menambahkan terminator baris default ke akhir objek saat ini StringBuilder .
AppendLine(String)	Menambahkan salinan string yang ditentukan diikuti oleh terminator baris default ke akhir objek saat ini StringBuilder .
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 .
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(StringBuilder)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu.
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[], Int32, Int32)	Menyisipkan representasi string dari subarray 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, 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, 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, Int32)	Menyisipkan satu atau beberapa salinan string tertentu 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, 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, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan karakter tertentu dengan karakter lain yang ditentukan.
Replace(Char, Char)	Mengganti semua kemunculan karakter tertentu dalam instans ini dengan karakter lain yang ditentukan.
Replace(String, String, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan string tertentu dengan string lain yang ditentukan.
Replace(String, String)	Mengganti semua kemunculan string tertentu dalam instans ini 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

Nama	Deskripsi
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Mengisi objek dengan data yang SerializationInfo diperlukan untuk mendeserialisasi objek saat ini StringBuilder .

Lihat juga

• String