StringBuilder Oluşturucular

Başvuru

Tanım

Ad Alanı:: System.Text

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Kaynak:: StringBuilder.cs

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.

Şunlara uygulanır

StringBuilder(Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

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

Şunlara uygulanır

StringBuilder(String)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

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);

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).

Şunlara uygulanır

StringBuilder(Int32, Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

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

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.

Şunlara uygulanır

StringBuilder(String, Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

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);

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

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

Ayrıca bkz.

Capacity

Şunlara uygulanır

StringBuilder(String, Int32, Int32, Int32)

Kaynak:: StringBuilder.cs

Kaynak:: StringBuilder.cs

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);

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

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

Ayrıca bkz.

Capacity

Şunlara uygulanır

Aracılığıyla paylaş

StringBuilder Oluşturucular

Tanım

Aşırı Yüklemeler

StringBuilder()

Örnekler

Açıklamalar

Şunlara uygulanır

StringBuilder(Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StringBuilder(String)

Parametreler

Örnekler

Açıklamalar

Şunlara uygulanır

StringBuilder(Int32, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

StringBuilder(String, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StringBuilder(String, Int32, Int32, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar