StringBuilder Oluşturucular

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Runtime.dll

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

Aşırı Yüklemeler

StringBuilder()	StringBuilder sınıfının yeni bir örneğini başlatır.
StringBuilder(Int32)	Belirtilen kapasiteyi StringBuilder kullanarak sınıfının 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 StringBuilder kullanarak sınıfının yeni bir örneğini başlatır.
StringBuilder(String, Int32, Int32, Int32)	Belirtilen alt dizeden ve kapasiteden sınıfını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, parametre olmadan oluşturucunun StringBuilder nasıl çağrıldığını gösterir.

StringBuilder^ stringBuilder = gcnew StringBuilder;

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Açıklamalar

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

StringBuilder(Int32)

Kaynak:

StringBuilder.cs

Belirtilen kapasiteyi StringBuilder kullanarak sınıfının 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 = 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)

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 içerir (yani içerir Empty).

Örnekler

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

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)

Açıklamalar

ise valuenull, yeni StringBuilder boş dizeyi içerir (yani 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

önerilen başlangıç boyutu StringBuilder.

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 örnek, belirtilen kapasiteye ve maksimum kapasiteye sahip oluşturucunun StringBuilder nasıl çağrılduğunu gösterir.

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)

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ümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Kaynak:

StringBuilder.cs

Belirtilen dizeyi ve kapasiteyi StringBuilder kullanarak sınıfının 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 içerir (yani içerir Empty).

capacity

Int32

önerilen başlangıç boyutu StringBuilder.

Özel durumlar

ArgumentOutOfRangeException

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

Örnekler

Aşağıdaki örnek, bir ilk dize ve belirtilen kapasite ile oluşturucunun StringBuilder nasıl çağrılduğunu gösterir.

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)

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ı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 içerir (yani içerir Empty).

startIndex

Int32

Alt dizenin başladığı konum value .

length

Int32

Alt dizedeki karakter sayısı.

capacity

Int32

önerilen başlangıç boyutu StringBuilder.

Özel durumlar

ArgumentOutOfRangeException

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

-veya-

startIndex plus length içinde valuebir konum değildir.

Örnekler

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

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)

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