StringBuilder Klas

Definitie

Naamruimte:

System.Text

Assembly:

mscorlib.dll

Vertegenwoordigt een veranderlijke tekenreeks. Deze klasse kan niet worden overgenomen.

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

Overname

Object

StringBuilder

Kenmerken

SerializableAttribute ComVisibleAttribute

Implementeringen

ISerializable

Voorbeelden

In het volgende voorbeeld ziet u hoe u veel van de methoden aanroept die door de StringBuilder klasse zijn gedefinieerd.

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

Opmerkingen

Zie Aanvullende API-opmerkingen voor StringBuilder voor meer informatie over deze API.

Notities voor bellers

Wanneer u in .NET Core en in .NET Framework 4.0 en hoger het StringBuilder-object instantiëren door de constructor StringBuilder(Int32, Int32) aan te roepen, kan zowel de lengte als de capaciteit van het StringBuilder-exemplaar groter worden dan de waarde van de eigenschap MaxCapacity. Dit kan met name gebeuren wanneer u de Append(String) en AppendFormat(String, Object) methoden aanroept om kleine tekenreeksen toe te voegen.

Constructors

Name	Description
StringBuilder()	Initialiseert een nieuw exemplaar van de StringBuilder klasse.
StringBuilder(Int32, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse die begint met een opgegeven capaciteit en kan toenemen tot een opgegeven maximum.
StringBuilder(Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven capaciteit.
StringBuilder(String, Int32, Int32, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse op basis van de opgegeven subtekenreeks en capaciteit.
StringBuilder(String, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks en capaciteit.
StringBuilder(String)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks.

Eigenschappen

Name	Description
Capacity	Hiermee haalt u het maximum aantal tekens op dat kan worden opgenomen in het geheugen dat door de huidige instantie is toegewezen.
Chars[Int32]	Hiermee haalt u het teken op de opgegeven tekenpositie in dit exemplaar op of stelt u het in.
Length	Hiermee wordt de lengte van het huidige StringBuilder object opgehaald of ingesteld.
MaxCapacity	Hiermee haalt u de maximale capaciteit van dit exemplaar op.

Methoden

Name	Description
Append(Boolean)	Hiermee voegt u de tekenreeksweergave van een opgegeven Booleaanse waarde toe aan dit exemplaar.
Append(Byte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal zonder teken toe aan dit exemplaar.
Append(Char, Int32)	Voegt een opgegeven aantal kopieën van de tekenreeksweergave van een Unicode-teken toe aan dit exemplaar.
Append(Char)	Hiermee voegt u de tekenreeksweergave van een opgegeven Char object toe aan dit exemplaar.
Append(Char[], Int32, Int32)	Hiermee voegt u de tekenreeksweergave van een opgegeven submaarray unicode-tekens toe aan dit exemplaar.
Append(Char[])	Hiermee voegt u de tekenreeksweergave van de Unicode-tekens in een opgegeven matrix toe aan dit exemplaar.
Append(Char*, Int32)	Voegt een matrix van Unicode-tekens toe die beginnen bij een opgegeven adres aan dit exemplaar.
Append(Decimal)	Hiermee voegt u de tekenreeksweergave van een opgegeven decimaal getal toe aan dit exemplaar.
Append(Double)	Hiermee voegt u de tekenreeksweergave van een opgegeven drijvendekommagetal met dubbele precisie toe aan dit exemplaar.
Append(Int16)	Hiermee wordt de tekenreeksweergave van een opgegeven 16-bits geheel getal toegevoegd aan dit exemplaar.
Append(Int32)	Hiermee voegt u de tekenreeksweergave van een opgegeven 32-bits geheel getal toe aan dit exemplaar.
Append(Int64)	Hiermee voegt u de tekenreeksweergave van een opgegeven 64-bits geheel getal toe aan dit exemplaar.
Append(Object)	Hiermee voegt u de tekenreeksweergave van een opgegeven object toe aan dit exemplaar.
Append(SByte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal toe aan dit exemplaar.
Append(Single)	Hiermee voegt u de tekenreeksweergave van een opgegeven drijvendekommagetal met één precisie toe aan dit exemplaar.
Append(String, Int32, Int32)	Voegt een kopie van een opgegeven subtekenreeks toe aan dit exemplaar.
Append(String)	Voegt een kopie van de opgegeven tekenreeks toe aan dit exemplaar.
Append(UInt16)	Hiermee voegt u de tekenreeksweergave van een opgegeven 16-bits geheel getal zonder teken toe aan dit exemplaar.
Append(UInt32)	Hiermee voegt u de tekenreeksweergave van een opgegeven 32-bits geheel getal zonder teken toe aan dit exemplaar.
Append(UInt64)	Hiermee voegt u de tekenreeksweergave van een opgegeven 64-bits geheel getal zonder teken toe aan dit exemplaar.
AppendFormat(IFormatProvider, String, Object, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de drie argumenten met behulp van een opgegeven indelingsprovider.
AppendFormat(IFormatProvider, String, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de twee argumenten met behulp van een opgegeven indelingsprovider.
AppendFormat(IFormatProvider, String, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van één argument met behulp van een opgegeven indelingsprovider.
AppendFormat(IFormatProvider, String, Object[])	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een corresponderend argument in een parametermatrix met behulp van een opgegeven indelingsprovider.
AppendFormat(String, Object, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de drie argumenten.
AppendFormat(String, Object, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een van de twee argumenten.
AppendFormat(String, Object)	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van één argument.
AppendFormat(String, Object[])	Hiermee voegt u de tekenreeks toe die wordt geretourneerd door een tekenreeks met samengestelde notatie, die nul of meer opmaakitems bevat, toe te voegen aan dit exemplaar. Elk opmaakitem wordt vervangen door de tekenreeksweergave van een corresponderend argument in een parametermatrix.
AppendLine()	Hiermee voegt u de standaardregeleindteken toe aan het einde van het huidige StringBuilder object.
AppendLine(String)	Voegt een kopie van de opgegeven tekenreeks toe, gevolgd door het standaardregeleindteken aan het einde van het huidige StringBuilder object.
Clear()	Hiermee verwijdert u alle tekens uit het huidige StringBuilder exemplaar.
CopyTo(Int32, Char[], Int32, Int32)	Kopieert de tekens van een opgegeven segment van dit exemplaar naar een opgegeven segment van een doelmatrix Char .
EnsureCapacity(Int32)	Zorgt ervoor dat de capaciteit van dit exemplaar StringBuilder ten minste de opgegeven waarde is.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Equals(StringBuilder)	Retourneert een waarde die aangeeft of dit exemplaar gelijk is aan een opgegeven object.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Insert(Int32, Boolean)	Hiermee voegt u de tekenreeksweergave van een Booleaanse waarde in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Byte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Char)	Hiermee voegt u de tekenreeksweergave van een opgegeven Unicode-teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Char[], Int32, Int32)	Hiermee wordt de tekenreeksweergave van een opgegeven submaarray van Unicode-tekens in dit exemplaar ingevoegd op de opgegeven tekenpositie.
Insert(Int32, Char[])	Hiermee voegt u de tekenreeksweergave van een opgegeven matrix met Unicode-tekens in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Decimal)	Hiermee voegt u de tekenreeksweergave van een decimaal getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Double)	Hiermee voegt u de tekenreeksweergave van een drijvendekommagetal met dubbele precisie in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Int16)	Hiermee wordt de tekenreeksweergave van een opgegeven 16-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.
Insert(Int32, Int32)	Hiermee wordt de tekenreeksweergave van een opgegeven 32-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.
Insert(Int32, Int64)	Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Object)	Hiermee voegt u de tekenreeksweergave van een object in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, SByte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Single)	Hiermee voegt u de tekenreeksweergave van een drijvende kommanummer met één precisie in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, String, Int32)	Hiermee voegt u een of meer kopieën van een opgegeven tekenreeks in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, String)	Hiermee voegt u een tekenreeks in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt16)	Hiermee voegt u de tekenreeksweergave van een 16-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt32)	Hiermee voegt u de tekenreeksweergave van een 32-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt64)	Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
Remove(Int32, Int32)	Hiermee verwijdert u het opgegeven bereik van tekens uit dit exemplaar.
Replace(Char, Char, Int32, Int32)	Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven teken door een ander opgegeven teken.
Replace(Char, Char)	Vervangt alle exemplaren van een opgegeven teken in dit exemplaar door een ander opgegeven teken.
Replace(String, String, Int32, Int32)	Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven tekenreeks door een andere opgegeven tekenreeks.
Replace(String, String)	Vervangt alle exemplaren van een opgegeven tekenreeks in dit exemplaar door een andere opgegeven tekenreeks.
ToString()	Converteert de waarde van dit exemplaar naar een String.
ToString(Int32, Int32)	Converteert de waarde van een subtekenreeks van dit exemplaar naar een String.

Expliciete interface-implementaties

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Hiermee wordt een SerializationInfo object gevuld met de gegevens die nodig zijn om het huidige StringBuilder object te deserialiseren.

Zie ook

• String