StringBuilder Konstruktor

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Menginisialisasi instans baru kelas StringBuilder.

Overload

StringBuilder()	Menginisialisasi instans baru kelas StringBuilder.
StringBuilder(Int32)	Menginisialisasi instans StringBuilder baru kelas menggunakan kapasitas yang ditentukan.
StringBuilder(String)	Menginisialisasi instans StringBuilder baru kelas menggunakan string yang ditentukan.
StringBuilder(Int32, Int32)	Menginisialisasi instans StringBuilder baru kelas yang dimulai dengan kapasitas tertentu dan dapat tumbuh hingga maksimum 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.

StringBuilder()

Sumber:

StringBuilder.cs

Menginisialisasi instans baru kelas StringBuilder.

public:
 StringBuilder();

public StringBuilder ();

Public Sub New ()

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor tanpa parameter.

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Keterangan

Nilai string instans ini diatur ke String.Empty, dan kapasitas diatur ke kapasitas default khusus implementasi.

StringBuilder(Int32)

Sumber:

StringBuilder.cs

Menginisialisasi instans StringBuilder baru kelas menggunakan kapasitas yang ditentukan.

public:
 StringBuilder(int capacity);

public StringBuilder (int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

Parameter

capacity

Int32

Ukuran awal yang disarankan dari instans ini.

Pengecualian

ArgumentOutOfRangeException

capacity kurang dari nol.

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor dengan kapasitas tertentu.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Keterangan

Parameter capacity menentukan jumlah maksimum karakter yang dapat disimpan dalam memori yang dialokasikan oleh instans saat ini. Nilainya ditetapkan ke Capacity properti . Jika jumlah karakter yang akan disimpan dalam instans saat ini melebihi nilai ini capacity , StringBuilder objek mengalokasikan memori tambahan untuk menyimpannya.

Nilai string instans ini diatur ke String.Empty. Jika capacity nol, kapasitas default khusus implementasi digunakan.

Lihat juga

• Capacity

StringBuilder(String)

Sumber:

StringBuilder.cs

Menginisialisasi instans StringBuilder baru kelas menggunakan string yang ditentukan.

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

public StringBuilder (string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

Parameter

value

String

String yang digunakan untuk menginisialisasi nilai instans. Jika value adalah null, yang baru StringBuilder akan berisi string kosong (yaitu, berisi Empty).

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor dengan string yang ditentukan.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Keterangan

Jika value adalah null, yang baru StringBuilder akan berisi string kosong (yaitu, berisi Empty).

StringBuilder(Int32, Int32)

Sumber:

StringBuilder.cs

Menginisialisasi instans StringBuilder baru kelas yang dimulai dengan kapasitas tertentu dan dapat tumbuh hingga maksimum yang ditentukan.

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder (int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

Parameter

capacity

Int32

Ukuran awal yang disarankan StringBuilderdari .

maxCapacity

Int32

Jumlah maksimum karakter yang dapat dimuat string saat ini.

Pengecualian

ArgumentOutOfRangeException

maxCapacity kurang dari satu, capacity kurang dari nol, atau capacity lebih besar dari maxCapacity.

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor dengan kapasitas yang ditentukan dan kapasitas maksimum.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Keterangan

Parameter capacity menentukan jumlah maksimum karakter yang dapat disimpan dalam memori yang dialokasikan oleh instans saat ini. Nilainya ditetapkan ke Capacity properti . Jika jumlah karakter yang akan disimpan dalam instans saat ini melebihi nilai ini capacity , StringBuilder objek mengalokasikan memori tambahan untuk menyimpannya.

Jika capacity nol, kapasitas default khusus implementasi digunakan.

Properti maxCapacity menentukan jumlah karakter maksimum yang dapat dipegang instans saat ini. Nilainya ditetapkan ke MaxCapacity properti . Jika jumlah karakter yang akan disimpan dalam instans saat ini melebihi nilai ini maxCapacity , StringBuilder objek tidak mengalokasikan memori tambahan, tetapi sebaliknya melemparkan pengecualian.

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

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Sumber:

StringBuilder.cs

Menginisialisasi instans StringBuilder baru kelas menggunakan string dan kapasitas yang ditentukan.

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder (string? value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

Parameter

value

String

String yang digunakan untuk menginisialisasi nilai instans. Jika value adalah null, yang baru StringBuilder akan berisi string kosong (yaitu, berisi Empty).

capacity

Int32

Ukuran awal yang disarankan StringBuilderdari .

Pengecualian

ArgumentOutOfRangeException

capacity kurang dari nol.

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor dengan string awal dan kapasitas yang ditentukan.

String^ initialString = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Keterangan

Parameter capacity menentukan jumlah maksimum karakter yang dapat disimpan dalam memori yang dialokasikan oleh instans saat ini. Nilainya ditetapkan ke Capacity properti . Jika jumlah karakter yang akan disimpan dalam instans saat ini melebihi nilai ini capacity , StringBuilder objek mengalokasikan memori tambahan untuk menyimpannya.

Jika capacity nol, kapasitas default khusus implementasi digunakan.

Lihat juga

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Sumber:

StringBuilder.cs

Menginisialisasi instans StringBuilder baru kelas dari substring dan kapasitas yang ditentukan.

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);

public StringBuilder (string? value, int startIndex, int length, int capacity);

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parameter

value

String

String yang berisi substring yang digunakan untuk menginisialisasi nilai instans ini. Jika value adalah null, yang baru StringBuilder akan berisi string kosong (yaitu, berisi Empty).

startIndex

Int32

Posisi di value mana substring dimulai.

length

Int32

Jumlah karakter untuk substring.

capacity

Int32

Ukuran awal yang disarankan StringBuilderdari .

Pengecualian

ArgumentOutOfRangeException

capacity kurang dari nol.

-atau-

startIndex plus length bukan posisi dalam value.

Contoh

Contoh berikut menunjukkan cara memanggil StringBuilder konstruktor dengan string yang ditentukan.

String^ initialString = L"Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,startIndex,substringLength,capacity );

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

Keterangan

Parameter capacity menentukan jumlah maksimum karakter yang dapat disimpan dalam memori yang dialokasikan oleh instans saat ini. Nilainya ditetapkan ke Capacity properti . Jika jumlah karakter yang akan disimpan dalam instans saat ini melebihi nilai ini capacity , StringBuilder objek mengalokasikan memori tambahan untuk menyimpannya.

Jika capacity nol, kapasitas default khusus implementasi digunakan.

Lihat juga

• Capacity