StringBuilder Osztály

Definíció

Névtér:

System.Text

Szerelvény:

mscorlib.dll

Egy karaktersorozatot jelöl. Ez az osztály nem örökölhető.

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

Öröklődés

Object

StringBuilder

Attribútumok

SerializableAttribute ComVisibleAttribute

Megvalósítás

ISerializable

Példák

Az alábbi példa bemutatja, hogyan hívhatja meg az osztály által StringBuilder definiált metódusok nagy részét.

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

Megjegyzések

Az API-val kapcsolatos további információkért lásd a StringBuilder kiegészítő API-megjegyzéseit.

Megjegyzések a hívókhoz

Az .NET Core és .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a AppendFormat(String, Object) metódusokat és a Append(String) metódusokat.

Konstruktorok

Name	Description
StringBuilder()	Inicializálja a StringBuilder osztály új példányát.
StringBuilder(Int32, Int32)	Inicializálja az StringBuilder osztály egy új példányát, amely egy megadott kapacitással kezdődik, és egy megadott maximumra nőhet.
StringBuilder(Int32)	Inicializálja az osztály új példányát a StringBuilder megadott kapacitás használatával.
StringBuilder(String, Int32, Int32, Int32)	Inicializálja az osztály új példányát a StringBuilder megadott alsztringből és kapacitásból.
StringBuilder(String, Int32)	Inicializálja az osztály új példányát a megadott sztring StringBuilder és kapacitás használatával.
StringBuilder(String)	Inicializálja az osztály új példányát StringBuilder a megadott sztring használatával.

Tulajdonságok

Name	Description
Capacity	Lekéri vagy beállítja az aktuális példány által lefoglalt memóriában tárolható karakterek maximális számát.
Chars[Int32]	Lekéri vagy beállítja a karaktert a megadott karakterpozícióban ebben a példányban.
Length	Lekéri vagy beállítja az aktuális StringBuilder objektum hosszát.
MaxCapacity	Lekéri a példány maximális kapacitását.

Metódusok

Name	Description
Append(Boolean)	Hozzáfűzi egy adott logikai érték sztringképét ehhez a példányhoz.
Append(Byte)	Hozzáfűzi a megadott 8 bites, aláíratlan egész szám sztringképét ehhez a példányhoz.
Append(Char, Int32)	Egy Unicode-karakter sztringképének megadott számú másolatát fűzi hozzá ehhez a példányhoz.
Append(Char)	Hozzáfűzi egy adott Char objektum sztringképét ehhez a példányhoz.
Append(Char[], Int32, Int32)	Hozzáfűzi a Unicode-karakterek megadott alarráinak sztringképét ehhez a példányhoz.
Append(Char[])	Hozzáfűzi a megadott tömb Unicode-karaktereinek sztringképét ehhez a példányhoz.
Append(Char*, Int32)	Hozzáfűz egy Unicode-karakterekből álló tömböt, amely egy megadott címen kezdődik a példányhoz.
Append(Decimal)	Hozzáfűzi egy megadott tizedesjegy sztringképét ehhez a példányhoz.
Append(Double)	Hozzáfűzi egy megadott két pontosságú lebegőpontos szám sztringképét ehhez a példányhoz.
Append(Int16)	Hozzáfűzi a megadott 16 bites aláírt egész szám sztringképét ehhez a példányhoz.
Append(Int32)	Hozzáfűzi a megadott 32 bites aláírt egész szám sztringképét ehhez a példányhoz.
Append(Int64)	Hozzáfűzi a megadott 64 bites aláírt egész szám sztringképét ehhez a példányhoz.
Append(Object)	Hozzáfűzi egy adott objektum sztringképét ehhez a példányhoz.
Append(SByte)	Hozzáfűzi a megadott 8 bites aláírt egész szám sztringképét ehhez a példányhoz.
Append(Single)	Hozzáfűzi egy megadott egy pontosságú lebegőpontos szám sztringképét ehhez a példányhoz.
Append(String, Int32, Int32)	Hozzáfűzi a példányhoz egy adott részszúrás másolatát.
Append(String)	Hozzáfűzi a megadott sztring másolatát ehhez a példányhoz.
Append(UInt16)	Hozzáfűzi a megadott 16 bites aláíratlan egész szám sztringképét ehhez a példányhoz.
Append(UInt32)	Hozzáfűzi a megadott 32 bites aláíratlan egész szám sztringképét ehhez a példányhoz.
Append(UInt64)	Hozzáfűzi a megadott 64 bites aláíratlan egész szám sztringképét ehhez a példányhoz.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elemet felvált a megadott formátumszolgáltatót használó három argumentum sztring-ábrázolása.
AppendFormat(IFormatProvider, String, Object, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elem helyébe egy megadott formátumszolgáltatót használó két argumentum sztring-ábrázolása lép.
AppendFormat(IFormatProvider, String, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elemet egy adott formátumszolgáltató használatával egyetlen argumentum sztring-ábrázolása vált fel.
AppendFormat(IFormatProvider, String, Object[])	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elemet egy adott formátumszolgáltatót használó paramétertömb megfelelő argumentumának sztring-ábrázolása vált fel.
AppendFormat(String, Object, Object, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elem helyébe a három argumentum valamelyikének sztring-ábrázolása kerül.
AppendFormat(String, Object, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elem helyébe két argumentum valamelyikének sztring-ábrázolása kerül.
AppendFormat(String, Object)	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elemet egyetlen argumentum sztring-ábrázolása vált fel.
AppendFormat(String, Object[])	Hozzáfűzi a visszaadott sztringet egy összetett formátumú sztring feldolgozásával, amely nulla vagy több formázási elemet tartalmaz ehhez a példányhoz. Minden formázási elemet egy paramétertömb megfelelő argumentumának sztring-ábrázolása vált fel.
AppendLine()	Hozzáfűzi az alapértelmezett sor-terminátort az aktuális StringBuilder objektum végéhez.
AppendLine(String)	Hozzáfűzi a megadott sztring egy példányát, majd az alapértelmezett vonal-terminátort az aktuális StringBuilder objektum végéhez.
Clear()	Eltávolítja az összes karaktert az aktuális StringBuilder példányból.
CopyTo(Int32, Char[], Int32, Int32)	Másolja a karaktereket a példány egy adott szegmenséből egy céltömb Char adott szegmensére.
EnsureCapacity(Int32)	Biztosítja, hogy a példány kapacitása StringBuilder legalább a megadott érték legyen.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Equals(StringBuilder)	Egy értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Insert(Int32, Boolean)	Beszúrja a logikai érték sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Byte)	Beszúrja a megadott 8 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Char)	Beszúrja egy megadott Unicode-karakter sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Char[], Int32, Int32)	Beszúrja a Unicode-karakterek megadott alarráinak sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Char[])	Beszúrja egy megadott Unicode-karaktertömb sztringképét ebbe a példányba a megadott karakterpozícióban.
Insert(Int32, Decimal)	Beszúrja a decimális szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Double)	Beszúrja a kettős pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int16)	Beszúrja egy megadott 16 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int32)	Beszúrja a megadott 32 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int64)	Beszúrja egy 64 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Object)	Beszúrja egy objektum sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, SByte)	Beszúrja a megadott 8 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Single)	Beszúrja egy egy pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, String, Int32)	Egy adott sztring egy vagy több példányát szúrja be ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, String)	Sztring beszúrása ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt16)	Beszúrja egy 16 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt32)	Beszúrja egy 32 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt64)	Egy 64 bites aláíratlan egész szám sztringképét szúrja be ebbe a példányba a megadott karakterhelyzetben.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Remove(Int32, Int32)	Eltávolítja a megadott karaktertartományt ebből a példányból.
Replace(Char, Char, Int32, Int32)	A példány egy részszúrásán belül egy adott karakter összes előfordulását lecseréli egy másik megadott karakterre.
Replace(Char, Char)	Egy adott karakter minden előfordulását lecseréli ebben a példányban egy másik megadott karakterre.
Replace(String, String, Int32, Int32)	Egy adott sztring összes előfordulását lecseréli a példány egy részsztringen belül egy másik megadott sztringre.
Replace(String, String)	Egy adott sztring minden előfordulását lecseréli ebben a példányban egy másik megadott sztringre.
ToString()	A példány értékét átalakítja egy String.
ToString(Int32, Int32)	A példány egy részszűkítésének értékét átalakítja egy String.

Explicit interfész-implementációk

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Feltölt egy SerializationInfo objektumot az aktuális StringBuilder objektum deszerializálásához szükséges adatokkal.

Lásd még

• String