StringBuilder Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

StringBuilder.cs

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

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

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

type StringBuilder = class
    interface ISerializable

Public NotInheritable Class StringBuilder
Implements ISerializable

Devralma

Object

StringBuilder

Uygulamalar

ISerializable

Örnekler

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

using namespace System;
using namespace System::Text;

int main()
{
    // Create a StringBuilder that expects to hold 50 characters.
    // Initialize the StringBuilder with "ABC".
    StringBuilder^ sb = gcnew StringBuilder("ABC", 50);

    // Append three characters (D, E, and F) to the end of the
    // StringBuilder.
    sb->Append(gcnew array<Char>{'D', 'E', 'F'});

    // Append a format string to the end of the StringBuilder.
    sb->AppendFormat("GHI{0}{1}", (Char)'J', (Char)'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

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. StringBuilderiçin ek API açıklamaları.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, 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 ötesinde büyüyebilir. Bu durum özellikle küçük dizeleri eklemek için Append(String) ve AppendFormat(String, Object) yöntemlerini çağırdığınızda oluşabilir.

Oluşturucular

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

Özellikler

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 nesnesinin uzunluğunu alır veya ayarlar.
MaxCapacity	Bu örneğin maksimum kapasitesini alır.

Yöntemler

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)	Belirtilen Char nesnesinin dize gösterimini bu örneğe ekler.
Append(Char*, Int32)	Belirtilen bir adreste başlayan unicode karakter dizisini bu örneğe ekler.
Append(Char, Int32)	Unicode karakterinin dize gösteriminin belirtilen sayıda kopyasını bu örneğe ekler.
Append(Char[])	Belirtilen dizideki Unicode karakterlerinin dize gösterimini bu örneğe ekler.
Append(Char[], Int32, Int32)	Belirtilen Unicode karakterlerinin alt dizisini dize gösterimini 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(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Belirtilen biçimi kullanarak belirtilen ilişkilendirilmiş dizeyi 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(ReadOnlyMemory<Char>)	Belirtilen salt okunur karakter bellek bölgesinin dize gösterimini bu örneğe ekler.
Append(ReadOnlySpan<Char>)	Belirtilen salt okunur karakter aralığının 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)	Belirtilen dizenin bir kopyasını bu örneğe ekler.
Append(String, Int32, Int32)	Belirtilen alt dizenin bir kopyasını bu örneğe ekler.
Append(StringBuilder)	Belirtilen dize oluşturucusunun dize gösterimini bu örneğe ekler.
Append(StringBuilder, Int32, Int32)	Belirtilen dize oluşturucusunun içindeki bir alt dizenin kopyasını bu örneğe ekler.
Append(StringBuilder+AppendInterpolatedStringHandler)	Belirtilen ilişkilendirilmiş dizeyi 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, CompositeFormat, 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şkenlerden herhangi birinin dize gösterimiyle değiştirilir.
AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<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şkenlerden herhangi 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, 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, 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[])	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)	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, 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, 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[])	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.
AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)	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şkenlerden herhangi birinin dize gösterimiyle değiştirilir.
AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)	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şkenlerden herhangi birinin dize gösterimiyle değiştirilir.
AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)	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şkenlerden herhangi birinin dize gösterimiyle değiştirilir.
AppendJoin(Char, Object[])	Sağlanan nesne dizisindeki öğelerin dize gösterimlerini birleştirir, her üye arasında belirtilen karakter ayırıcısını kullanarak sonucu dize oluşturucusunun geçerli örneğine ekler.
AppendJoin(Char, String[])	Sağlanan dizinin dizelerini birleştirir ve her dize arasında belirtilen karakter ayırıcısını kullanarak sonucu dize oluşturucusunun geçerli örneğine ekler.
AppendJoin(String, Object[])	Sağlanan nesne dizisindeki öğelerin dize gösterimlerini birleştirir ve her üye arasında belirtilen ayırıcıyı kullanarak sonucu dize oluşturucusunun geçerli örneğine ekler.
AppendJoin(String, String[])	Sağlanan dizinin dizelerini birleştirir ve her dize arasındaki belirtilen ayırıcıyı kullanarak sonucu dize oluşturucusunun geçerli örneğine ekler.
AppendJoin<T>(Char, IEnumerable<T>)	Her üye arasında belirtilen karakter ayırıcısını kullanarak bir koleksiyonun üyelerini birleştirir ve ekler.
AppendJoin<T>(String, IEnumerable<T>)	Her üye arasında belirtilen ayırıcıyı kullanarak bir koleksiyonun üyelerini birleştirir ve ekler.
AppendLine()	Varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Belirtilen biçimi kullanarak belirtilen ilişkilendirilmiş dizeyi ekler ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.
AppendLine(String)	Belirtilen dizenin bir kopyasını ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Belirtilen ilişkilendirilmiş dizeyi ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.
Clear()	Geçerli StringBuilder örneğindeki tüm karakterleri kaldırır.
CopyTo(Int32, Char[], Int32, Int32)	Karakterleri bu örneğin belirtilen bir kesiminden hedef Char dizisinin belirtilen kesimine kopyalar.
CopyTo(Int32, Span<Char>, Int32)	Karakterleri bu örneğin belirtilen bir kesiminden hedef Char yayılmasına kopyalar.
EnsureCapacity(Int32)	bu StringBuilder örneğinin 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(ReadOnlySpan<Char>)	Bu örnekteki karakterlerin belirtilen salt okunur karakter aralığındaki karakterlere eşit olup olmadığını belirten bir değer döndürür.
Equals(StringBuilder)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.
GetChunks()	Bu StringBuilder örneğinden oluşturulan bir ReadOnlyMemory<Char> temsil edilen karakter öbekleri arasında yineleme yapmak için kullanılabilecek bir nesne 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[])	Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakter dizisinin dize gösterimini ekler.
Insert(Int32, Char[], Int32, Int32)	Belirtilen karakter konumundaki bu örneğe belirtilen Unicode karakterlerinin bir alt 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, ReadOnlySpan<Char>)	Belirtilen karakter konumunda bu örneğe karakter sırasını 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)	Belirtilen karakter konumunda bu örneğe bir dize ekler.
Insert(Int32, String, Int32)	Belirtilen karakter konumunda belirtilen dizenin bir veya daha fazla kopyasını bu örneğe 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)	Bu örnekte belirtilen bir karakterin tüm oluşumlarını başka bir belirtilen karakterle değiştirir.
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(String, String)	Bu örnekte belirtilen dizenin tüm oluşumlarını başka bir belirtilen dizeyle 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.
ToString()	Bu örneğin değerini bir Stringdönüştürür.
ToString(Int32, Int32)	Bu örneğin alt dizesinin değerini Stringdönüştürür.

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

bir SerializationInfo nesnesini geçerli StringBuilder nesnesini seri durumdan çıkarmak için gereken verilerle doldurur.

Uzantı Metotları

Append(StringBuilder, StringSegment)	Verilen StringSegmentStringBuilderekleyin.
AppendRedacted(StringBuilder, Redactor, ReadOnlySpan<Char>)	Hassas olabilecek verileri yeniden oluşturur ve StringBuilder bir örneğe ekler.
AppendRedacted(StringBuilder, Redactor, String)	Hassas olabilecek verileri yeniden oluşturur ve StringBuilder bir örneğe ekler.

Ayrıca bkz.

• String