StringBuilder Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Runtime.dll

Source:

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, sınıfı tarafından tanımlanan yöntemlerin birçoğunun nasıl çağrıldığı gösterilmektedir StringBuilder .

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

Arayanlara Notlar

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

Oluşturucular

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(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)	Belirtilen dizeyi StringBuilder kullanarak sınıfının 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 yeni bir örneğini StringBuilder 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 nesnenin 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 nesnenin 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 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 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şkenin 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 ve 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ında 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 nesnenin 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 nesnenin 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 örnekteki tüm karakterleri kaldırır.
CopyTo(Int32, Char[], Int32, Int32)	Bu örneğin belirtilen kesimindeki karakterleri hedef Char dizinin belirtilen kesimine kopyalar.
CopyTo(Int32, Span<Char>, Int32)	Bu örneğin belirtilen bir kesimindeki karakterleri hedef Char yayılmaya 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(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ğeri döndürür.
GetChunks()	Bu StringBuilder örnekten oluşturulan içinde temsil edilen karakter öbekleri arasında yineleme yapmak için kullanılabilecek bir ReadOnlyMemory<Char> nesne döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini 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 Unicode karakterinin dize gösterimini belirtilen karakter konumunda bu örneğe ekler.
Insert(Int32, Char[])	Belirtilen unicode karakter dizisinin dize gösterimini bu örneğe belirtilen karakter konumunda ekler.
Insert(Int32, Char[], Int32, Int32)	Belirtilen karakter konumundaki bu örneğe, belirtilen Unicode karakterlerinin belirtilen 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)	Belirtilen karakter konumunda bu örneğe çift duyarlıklı kayan nokta sayısının dize gösterimini ekler.
Insert(Int32, Int16)	Belirtilen 16 bit imzalı tamsayının dize gösterimini bu örneğe belirtilen karakter konumunda ekler.
Insert(Int32, Int32)	Belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe belirtilen karakter konumunda 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 8 bit imzalı tamsayının dize gösterimini bu örneğe belirtilen karakter konumunda 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 bir dizenin bir veya daha fazla kopyasını belirtilen karakter konumunda 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 konumunda 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 Objectöğesinin sığ 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 karakterin tüm oluşumlarını belirtilen başka bir 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ı belirtilen başka bir 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 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ı

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Bir SerializationInfo nesneyi geçerli StringBuilder nesnenin seri durumdan çıkarılması için gereken verilerle doldurur.

Ayrıca bkz.

• String