StringBuilder Oluşturucular

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

StringBuilder sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
StringBuilder()	StringBuilder sınıfının yeni bir örneğini başlatır.
StringBuilder(Int32)	Belirtilen kapasiteyi kullanarak sınıfın StringBuilder yeni bir örneğini başlatır.
StringBuilder(String)	Belirtilen dizeyi StringBuilder kullanarak sınıfının yeni bir örneğini başlatır.
StringBuilder(Int32, Int32)	Sınıfın StringBuilder belirtilen kapasiteyle başlayan ve belirtilen üst sınıra kadar büyüyebilen yeni bir örneğini başlatır.
StringBuilder(String, Int32)	Belirtilen dizeyi ve kapasiteyi kullanarak sınıfın StringBuilder yeni bir örneğini başlatır.
StringBuilder(String, Int32, Int32, Int32)	Belirtilen alt dizeden ve kapasiteden sınıfın yeni bir örneğini StringBuilder başlatır.

StringBuilder()

Kaynak:

StringBuilder.cs

StringBuilder sınıfının yeni bir örneğini başlatır.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Örnekler

Aşağıdaki örnek, oluşturucunun StringBuilder parametre olmadan nasıl çağrıldığını gösterir.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Açıklamalar

Bu örneğin dize değeri olarak ayarlanır String.Emptyve kapasite uygulamaya özgü varsayılan kapasiteye ayarlanır.

StringBuilder(Int32)

Kaynak:

StringBuilder.cs

Belirtilen kapasiteyi kullanarak sınıfın StringBuilder yeni bir örneğini başlatır.

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

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

Public Sub New (capacity As Integer)

Parametreler

capacity

Int32

Bu örneğin önerilen başlangıç boyutu.

Özel durumlar

ArgumentOutOfRangeException

capacity, sıfırdan küçüktür.

Örnekler

Aşağıdaki örnek, belirtilen kapasiteye sahip oluşturucunun StringBuilder nasıl çağrılduğunu gösterir.

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)

Açıklamalar

parametresi, capacity geçerli örnek tarafından ayrılan bellekte depolanabilecek en fazla karakter sayısını tanımlar. Değeri özelliğine Capacity atanır. Geçerli örnekte depolanacak karakter sayısı bu capacity değeri aşarsa, StringBuilder nesne bunları depolamak için ek bellek ayırır.

Bu örneğin dize değeri olarak String.Emptyayarlanır. Sıfır ise capacity uygulamaya özgü varsayılan kapasite kullanılır.

Ayrıca bkz.

• Capacity

StringBuilder(String)

Kaynak:

StringBuilder.cs

Belirtilen dizeyi StringBuilder kullanarak sınıfının yeni bir örneğini başlatır.

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

public StringBuilder(string? value);

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

Public Sub New (value As String)

Parametreler

value

String

Örneğin değerini başlatmak için kullanılan dize. ise valuenull, yeni StringBuilder boş dizeyi (yani içerir) içerir Empty.

Örnekler

Aşağıdaki örnekte, oluşturucunun StringBuilder belirtilen dizeyle nasıl çağrılacakları gösterilmektedir.

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)

Açıklamalar

ise valuenull, yeni StringBuilder boş dizeyi (yani içerir) içerir Empty.

StringBuilder(Int32, Int32)

Kaynak:

StringBuilder.cs

Sınıfın StringBuilder belirtilen kapasiteyle başlayan ve belirtilen üst sınıra kadar büyüyebilen yeni bir örneğini başlatır.

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)

Parametreler

capacity

Int32

öğesinin StringBuilderönerilen başlangıç boyutu.

maxCapacity

Int32

Geçerli dizenin içerebileceği karakter sayısı üst sınırı.

Özel durumlar

ArgumentOutOfRangeException

maxCapacity birden küçüktür, capacity sıfırdan küçüktür veya capacity değerinden maxCapacitybüyüktür.

Örnekler

Aşağıdaki örnekte, belirtilen kapasiteye ve maksimum kapasiteye sahip oluşturucunun StringBuilder nasıl çağrılacakları gösterilmektedir.

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)

Açıklamalar

parametresi, capacity geçerli örnek tarafından ayrılan bellekte depolanabilecek en fazla karakter sayısını tanımlar. Değeri özelliğine Capacity atanır. Geçerli örnekte depolanacak karakter sayısı bu capacity değeri aşarsa, StringBuilder nesne bunları depolamak için ek bellek ayırır.

Sıfır ise capacity uygulamaya özgü varsayılan kapasite kullanılır.

özelliği, maxCapacity geçerli örneğin tutabileceği en fazla karakter sayısını tanımlar. Değeri özelliğine MaxCapacity atanır. Geçerli örnekte depolanacak karakter sayısı bu maxCapacity değeri aşarsa, StringBuilder nesne ek bellek ayırmaz, bunun yerine bir özel durum oluşturur.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerinde oluşturucuyu çağırarak StringBuilder nesnesinin örneğini StringBuilder(Int32, Int32) oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine geçebilir. Bu, özellikle küçük dizeleri eklemek için ve Append(String) yöntemlerini çağırdığınızda AppendFormat(String, Object) oluşabilir.

Ayrıca bkz.

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Kaynak:

StringBuilder.cs

Belirtilen dizeyi ve kapasiteyi kullanarak sınıfın StringBuilder yeni bir örneğini başlatır.

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)

Parametreler

value

String

Örneğin değerini başlatmak için kullanılan dize. ise valuenull, yeni StringBuilder boş dizeyi (yani içerir) içerir Empty.

capacity

Int32

öğesinin StringBuilderönerilen başlangıç boyutu.

Özel durumlar

ArgumentOutOfRangeException

capacity, sıfırdan küçüktür.

Örnekler

Aşağıdaki örnekte, oluşturucunun StringBuilder bir başlangıç dizesi ve belirtilen kapasiteyle nasıl çağrılacakları gösterilmektedir.

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)

Açıklamalar

parametresi, capacity geçerli örnek tarafından ayrılan bellekte depolanabilecek en fazla karakter sayısını tanımlar. Değeri özelliğine Capacity atanır. Geçerli örnekte depolanacak karakter sayısı bu capacity değeri aşarsa, StringBuilder nesne bunları depolamak için ek bellek ayırır.

Sıfır ise capacity uygulamaya özgü varsayılan kapasite kullanılır.

Ayrıca bkz.

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Kaynak:

StringBuilder.cs

Belirtilen alt dizeden ve kapasiteden sınıfın yeni bir örneğini StringBuilder başlatır.

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)

Parametreler

value

String

Bu örneğin değerini başlatmak için kullanılan alt dizeyi içeren dize. ise valuenull, yeni StringBuilder boş dizeyi (yani içerir) içerir Empty.

startIndex

Int32

Alt dizenin başladığı konum value .

length

Int32

Alt dizedeki karakter sayısı.

capacity

Int32

öğesinin StringBuilderönerilen başlangıç boyutu.

Özel durumlar

ArgumentOutOfRangeException

capacity, sıfırdan küçüktür.

-veya-

startIndex artı length , içinde valuebir konum değildir.

Örnekler

Aşağıdaki örnekte, oluşturucunun StringBuilder belirtilen dizeyle nasıl çağrılacakları gösterilmektedir.

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)

Açıklamalar

parametresi, capacity geçerli örnek tarafından ayrılan bellekte depolanabilecek en fazla karakter sayısını tanımlar. Değeri özelliğine Capacity atanır. Geçerli örnekte depolanacak karakter sayısı bu capacity değeri aşarsa, StringBuilder nesne bunları depolamak için ek bellek ayırır.

Sıfır ise capacity uygulamaya özgü varsayılan kapasite kullanılır.

Ayrıca bkz.

• Capacity