StringBuilder Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

mscorlib.dll

Değiştirilebilir karakter dizesini temsil eder. Bu sınıf devralınamaz.

public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Devralma

Object

StringBuilder

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

ISerializable

Örnekler

Aşağıdaki örnekte, sınıfı tarafından tanımlanan yöntemlerin birçoğunun nasıl çağrıldığı gösterilmektedir StringBuilder .

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

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. StringBuilder için ek API açıklamaları.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerinde, StringBuilder(Int32, Int32) oluşturucusunu çağırarak StringBuilder nesnesinin örneğini oluştururken, StringBuilder örneğinin hem uzunluğu hem de kapasitesi MaxCapacity özelliğinin 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.

Oluşturucular

Name	Description
StringBuilder()	StringBuilder 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(Int32)	Belirtilen 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(String, Int32)	Belirtilen dizeyi ve 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.

Özellikler

Name	Description
Capacity	Geçerli örnek tarafından ayrılan bellekte bulunabilecek en fazla karakter sayısını alır veya ayarlar.
Chars[Int32]	Bu örnekte belirtilen karakter konumundaki karakteri alır veya ayarlar.
Length	Geçerli StringBuilder nesnenin uzunluğunu alır veya ayarlar.
MaxCapacity	Bu örneğin maksimum kapasitesini alır.

Yöntemler

Name	Description
Append(Boolean)	Belirtilen Boole değerinin dize gösterimini bu örneğe ekler.
Append(Byte)	Belirtilen 8 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.
Append(Char, Int32)	Unicode karakterinin dize gösteriminin belirtilen sayıda kopyasını bu örneğe ekler.
Append(Char)	Belirtilen Char bir nesnenin dize gösterimini bu örneğe ekler.
Append(Char[], Int32, Int32)	Belirtilen Unicode karakterlerinin alt dizisini dize gösterimini bu örneğe ekler.
Append(Char[])	Belirtilen dizideki Unicode karakterlerinin dize gösterimini bu örneğe ekler.
Append(Char*, Int32)	Belirtilen bir adreste başlayan unicode karakter dizisini bu örneğe ekler.
Append(Decimal)	Belirtilen ondalık sayının dize gösterimini bu örneğe ekler.
Append(Double)	Belirtilen çift duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.
Append(Int16)	Belirtilen 16 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Append(Int32)	Belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Append(Int64)	Belirtilen 64 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Append(Object)	Belirtilen bir nesnenin dize gösterimini bu örneğe ekler.
Append(SByte)	Belirtilen 8 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Append(Single)	Belirtilen tek duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.
Append(String, Int32, Int32)	Belirtilen alt dizenin bir kopyasını bu örneğe ekler.
Append(String)	Belirtilen dizenin bir kopyasını bu örneğe ekler.
Append(UInt16)	Belirtilen 16 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.
Append(UInt32)	Belirtilen 32 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.
Append(UInt64)	Belirtilen 64 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, belirtilen biçim sağlayıcısı kullanılarak üç bağımsız değişkenden birinin dize gösterimiyle değiştirilir.
AppendFormat(IFormatProvider, String, Object, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, belirtilen biçim sağlayıcısı kullanılarak iki bağımsız değişkenden birinin dize gösterimiyle değiştirilir.
AppendFormat(IFormatProvider, String, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, belirtilen biçim sağlayıcısı kullanılarak tek bir bağımsız değişkenin dize gösterimiyle değiştirilir.
AppendFormat(IFormatProvider, String, Object[])	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, belirtilen biçim sağlayıcısı kullanılarak parametre dizisindeki karşılık gelen bağımsız değişkenin dize gösterimiyle değiştirilir.
AppendFormat(String, Object, Object, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, üç bağımsız değişkenden birinin dize gösterimiyle değiştirilir.
AppendFormat(String, Object, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, iki bağımsız değişkenden birinin dize gösterimiyle değiştirilir.
AppendFormat(String, Object)	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, tek bir bağımsız değişkenin dize gösterimiyle değiştirilir.
AppendFormat(String, Object[])	Sıfır veya daha fazla biçim öğesi içeren bileşik biçim dizesini işleyerek döndürülen dizeyi bu örneğe ekler. Her biçim öğesi, parametre dizisindeki karşılık gelen bağımsız değişkenin dize gösterimiyle değiştirilir.
AppendLine()	Varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.
AppendLine(String)	Belirtilen dizenin bir kopyasını ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.
Clear()	Geçerli StringBuilder örnekteki tüm karakterleri kaldırır.
CopyTo(Int32, Char[], Int32, Int32)	Karakterleri bu örneğin belirtilen bir kesiminden hedef Char dizinin belirtilen kesimine kopyalar.
EnsureCapacity(Int32)	Bu örneğinin StringBuilder kapasitesinin en az belirtilen değer olmasını sağlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Equals(StringBuilder)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Insert(Int32, Boolean)	Bir Boole değerinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Byte)	Belirtilen 8 bit işaretsiz tamsayının dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Char)	Belirtilen bir Unicode karakterinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Char[], Int32, Int32)	Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakterlerinin bir alt dizisinin dize gösterimini ekler.
Insert(Int32, Char[])	Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakter dizisinin dize gösterimini ekler.
Insert(Int32, Decimal)	Belirtilen karakter konumunda bu örneğe ondalık bir sayının dize gösterimini ekler.
Insert(Int32, Double)	Bu örneğe belirtilen karakter konumunda çift duyarlıklı kayan nokta sayısının dize gösterimini ekler.
Insert(Int32, Int16)	Belirtilen karakter konumunda belirtilen 16 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Insert(Int32, Int32)	Belirtilen karakter konumunda belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe ekler.
Insert(Int32, Int64)	Belirtilen karakter konumunda bu örneğe 64 bit imzalı tamsayının dize gösterimini ekler.
Insert(Int32, Object)	Bir nesnenin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, SByte)	Belirtilen karakter konumundaki bu örneğe belirtilen 8 bit imzalı tamsayının dize gösterimini ekler.
Insert(Int32, Single)	Belirtilen karakter konumunda bu örneğe tek duyarlıklı kayan nokta sayısının dize gösterimini ekler.
Insert(Int32, String, Int32)	Belirtilen karakter konumunda belirtilen dizenin bir veya daha fazla kopyasını bu örneğe ekler.
Insert(Int32, String)	Belirtilen karakter konumunda bu örneğe bir dize ekler.
Insert(Int32, UInt16)	Belirtilen karakter konumundaki bu örneğe 16 bit işaretsiz tamsayının dize gösterimini ekler.
Insert(Int32, UInt32)	Belirtilen karakter konumundaki bu örneğe 32 bit işaretsiz tamsayının dize gösterimini ekler.
Insert(Int32, UInt64)	Belirtilen karakter konumundaki bu örneğe 64 bit işaretsiz tamsayının dize gösterimini ekler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove(Int32, Int32)	Belirtilen karakter aralığını bu örnekten kaldırır.
Replace(Char, Char, Int32, Int32)	Bu örneğin bir alt dizesi içinde, belirtilen bir karakterin tüm oluşumlarını başka bir belirtilen karakterle değiştirir.
Replace(Char, Char)	Bu örnekte belirtilen bir karakterin tüm oluşumlarını başka bir belirtilen karakterle değiştirir.
Replace(String, String, Int32, Int32)	Bu örneğin bir alt dizesi içinde belirtilen dizenin tüm oluşumlarını başka bir belirtilen dizeyle değiştirir.
Replace(String, String)	Bu örnekte belirtilen dizenin tüm oluşumlarını başka bir belirtilen dizeyle değiştirir.
ToString()	Bu örneğin değerini değerine Stringdönüştürür.
ToString(Int32, Int32)	Bu örneğin alt dizesinin değerini değerine Stringdönüştürür.

Belirtik Arabirim Kullanımları

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Bir SerializationInfo nesneyi geçerli StringBuilder nesnenin seri durumdan çıkarılması için gereken verilerle doldurur.

Ayrıca bkz.

• String