StringBuilder Kelas
Definisi
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.
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan.
public ref class StringBuilder sealed
public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable
public sealed class StringBuilder
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class StringBuilder
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable
type StringBuilder = class
type StringBuilder = class
interface ISerializable
[<System.Serializable>]
type StringBuilder = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
interface ISerializable
Public NotInheritable Class StringBuilder
Public NotInheritable Class StringBuilder
Implements ISerializable
- Warisan
-
StringBuilder
- Atribut
- Penerapan
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 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.
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(IFormatProvider, String, ReadOnlySpan<Object>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
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(String, ReadOnlySpan<Object>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
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, ReadOnlySpan<Object>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
AppendJoin(Char, ReadOnlySpan<String>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
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, ReadOnlySpan<Object>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
AppendJoin(String, ReadOnlySpan<String>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
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 |
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 dari 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>) |
Menyisipkan 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(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32) |
Mewakili string karakter yang dapat diubah. Kelas ini tidak dapat diwariskan. |
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 . |
Metode Ekstensi
Append(StringBuilder, StringSegment) |
Tambahkan yang diberikan StringSegment ke StringBuilder. |
AppendRedacted(StringBuilder, Redactor, ReadOnlySpan<Char>) |
Meredaksi data yang berpotensi sensitif dan menambahkannya ke StringBuilder instans. |
AppendRedacted(StringBuilder, Redactor, String) |
Meredaksi data yang berpotensi sensitif dan menambahkannya ke StringBuilder instans. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk