StringBuilder Classe

Définition

Représente une chaîne de caractères mutable. Cette classe ne peut pas être héritée.

public ref class StringBuilder sealed
public ref class StringBuilder sealed : System::Runtime::Serialization::ISerializable
public sealed class StringBuilder
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class StringBuilder
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class StringBuilder : System.Runtime.Serialization.ISerializable
type StringBuilder = class
type StringBuilder = class
    interface ISerializable
[<System.Serializable>]
type StringBuilder = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringBuilder = class
    interface ISerializable
Public NotInheritable Class StringBuilder
Public NotInheritable Class StringBuilder
Implements ISerializable
Héritage
StringBuilder
Attributs
Implémente

Exemples

L’exemple suivant montre comment appeler de nombreuses méthodes définies par la StringBuilder classe .

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

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour StringBuilder.

Notes pour les appelants

Dans .NET Core et dans .NET Framework 4.0 et versions ultérieures, lorsque vous instanciez l’objet StringBuilder en appelant le StringBuilder(Int32, Int32) constructeur, la longueur et la capacité de l’instance StringBuilder peuvent dépasser la valeur de sa MaxCapacity propriété. Cela peut se produire en particulier lorsque vous appelez les Append(String) méthodes et AppendFormat(String, Object) pour ajouter de petites chaînes.

Constructeurs

StringBuilder()

Initialise une nouvelle instance de la classe StringBuilder.

StringBuilder(Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la capacité spécifiée.

StringBuilder(Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder qui commence avec une capacité spécifiée et peut croître jusqu'à un maximum spécifié.

StringBuilder(String)

Initialise une nouvelle instance de la classe StringBuilder à l'aide de la chaîne spécifiée.

StringBuilder(String, Int32)

Initialise une nouvelle instance de la classe StringBuilder en utilisant la chaîne et la capacité spécifiées.

StringBuilder(String, Int32, Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder à partir de la sous-chaîne et de la capacité spécifiées.

Propriétés

Capacity

Obtient ou définit le nombre maximal de caractères que peut contenir la mémoire allouée par l'instance actuelle.

Chars[Int32]

Obtient ou définit le caractère situé à la position de caractère spécifiée dans cette instance.

Length

Obtient ou définit la longueur de l'objet StringBuilder actuel.

MaxCapacity

Obtient la capacité maximale de cette instance.

Méthodes

Append(Boolean)

Ajoute à cette instance la représentation sous forme de chaîne d'une valeur booléenne spécifiée.

Append(Byte)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 8 bits non signé spécifié.

Append(Char)

Ajoute à cette instance la représentation sous forme de chaîne d’un objet Char spécifié.

Append(Char*, Int32)

Ajoute à cette instance un tableau de caractères Unicode commençant à une adresse spécifiée.

Append(Char, Int32)

Ajoute à cette instance un nombre spécifié de copies de la représentation sous forme de chaîne d'un caractère Unicode.

Append(Char[])

Ajoute à cette instance la représentation sous forme de chaîne des caractères Unicode d'un tableau spécifié.

Append(Char[], Int32, Int32)

Ajoute à cette instance la représentation sous forme de chaîne d'un sous-tableau spécifié de caractères Unicode.

Append(Decimal)

Ajoute à cette instance la représentation sous forme de chaîne d'un nombre décimal spécifié.

Append(Double)

Ajoute à cette instance la représentation sous forme de chaîne d'un nombre à virgule flottante double précision spécifié.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Ajoute la chaîne interpolée spécifiée à cette instance à l’aide du format spécifié.

Append(Int16)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 16 bits signé spécifié.

Append(Int32)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 32 bits signé spécifié.

Append(Int64)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 64 bits signé spécifié.

Append(Object)

Ajoute à cette instance la représentation sous forme de chaîne d'un objet spécifié.

Append(ReadOnlyMemory<Char>)

Ajoute à cette instance la représentation sous forme de chaîne d’une région de mémoire de caractères en lecture seule spécifiée.

Append(ReadOnlySpan<Char>)

Ajoute à cette instance la représentation sous forme de chaîne d’une étendue de caractères en lecture seule spécifiée.

Append(SByte)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 8 bits signé spécifié.

Append(Single)

Ajoute à cette instance la représentation sous forme de chaîne d'un nombre à virgule flottante simple précision spécifié.

Append(String)

Ajoute à cette instance une copie de la chaîne spécifiée.

Append(String, Int32, Int32)

Ajoute à cette instance une copie d'une sous-chaîne spécifiée.

Append(StringBuilder)

Ajoute à cette instance la représentation sous forme de chaîne d’un générateur de chaînes spécifié.

Append(StringBuilder, Int32, Int32)

Ajoute à cette instance une copie d’une sous-chaîne du générateur de chaînes spécifié.

Append(StringBuilder+AppendInterpolatedStringHandler)

Ajoute la chaîne interpolée spécifiée à cette instance.

Append(UInt16)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 16 bits non signé spécifié.

Append(UInt32)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 32 bits non signé spécifié.

Append(UInt64)

Ajoute à cette instance la représentation sous forme de chaîne d'un entier 64 bits non signé spécifié.

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des arguments à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, CompositeFormat, ReadOnlySpan<Object>)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des arguments à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un argument unique à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un argument parmi deux à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object, Object, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne d'un argument parmi trois à l'aide d'un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object[])

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de mise en forme est remplacé par la représentation sous forme de chaîne d'un argument correspondant dans un tableau de paramètres à l'aide d'un fournisseur de format spécifié.

AppendFormat(String, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne d'un argument unique.

AppendFormat(String, Object, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l'un des deux arguments possibles.

AppendFormat(String, Object, Object, Object)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l'un des trois arguments possibles.

AppendFormat(String, Object[])

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de mise en forme est remplacé par la représentation sous forme de chaîne d'un argument correspondant dans un tableau de paramètres.

AppendFormat<TArg0,TArg1,TArg2>(IFormatProvider, CompositeFormat, TArg0, TArg1, TArg2)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des arguments à l’aide d’un fournisseur de format spécifié.

AppendFormat<TArg0,TArg1>(IFormatProvider, CompositeFormat, TArg0, TArg1)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des arguments à l’aide d’un fournisseur de format spécifié.

AppendFormat<TArg0>(IFormatProvider, CompositeFormat, TArg0)

Ajoute à cette instance la chaîne retournée par le traitement d'une chaîne de format composite, qui contient un nombre supérieur ou égal à zéro d'éléments de mise en forme. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des arguments à l’aide d’un fournisseur de format spécifié.

AppendJoin(Char, Object[])

Concatène les représentations sous forme de chaîne des éléments dans le tableau d’objets fourni, en utilisant le séparateur de caractères spécifié entre chaque membre, puis ajoute le résultat à l’instance actuelle du générateur de chaînes.

AppendJoin(Char, String[])

Concatène les chaînes du tableau fourni en utilisant le séparateur de caractères spécifié entre chaque chaîne, puis ajoute le résultat à l’instance actuelle du générateur de chaînes.

AppendJoin(String, Object[])

Concatène les représentations sous forme de chaîne des éléments dans le tableau d’objets fourni, en utilisant le séparateur spécifié entre chaque membre, puis ajoute le résultat à l’instance actuelle du générateur de chaînes.

AppendJoin(String, String[])

Concatène les chaînes du tableau fourni en utilisant le séparateur spécifié entre chaque chaîne, puis ajoute le résultat à l’instance actuelle du générateur de chaînes.

AppendJoin<T>(Char, IEnumerable<T>)

Concatène et ajoute les membres d’une collection en utilisant le séparateur de caractères spécifié entre chaque membre.

AppendJoin<T>(String, IEnumerable<T>)

Concatène et ajoute les membres d’une collection en utilisant le séparateur spécifié entre chaque membre.

AppendLine()

Ajoute la marque de fin de ligne par défaut à la fin de l'objet StringBuilder actuel.

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Ajoute la chaîne interpolée spécifiée au format spécifié, suivie de la fin de ligne par défaut, à la fin de l’objet StringBuilder actuel.

AppendLine(String)

Ajoute une copie de la chaîne spécifiée suivie de la marque de fin de ligne par défaut à la fin de l'objet StringBuilder actuel.

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Ajoute la chaîne interpolée spécifiée, suivie du point de terminaison de ligne par défaut à la fin de l’objet StringBuilder actuel.

Clear()

Supprime tous les caractères de l'instance StringBuilder actuelle.

CopyTo(Int32, Char[], Int32, Int32)

Copie les caractères d'un segment spécifié de cette instance vers un segment spécifié d'un tableau Char de destination.

CopyTo(Int32, Span<Char>, Int32)

Copie les caractères d'un segment spécifié de cette instance dans une plage Char de destination.

EnsureCapacity(Int32)

Garantit que la capacité de cette instance de StringBuilder est au moins égale à la valeur spécifiée.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Equals(ReadOnlySpan<Char>)

Renvoie une valeur indiquant si les caractères de cette instance sont égaux à ceux d'une plage spécifiée de caractères en lecture seule.

Equals(StringBuilder)

Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.

GetChunks()

Retourne un objet qui peut être utilisé pour itérer au sein des blocs de caractères représentés dans un ReadOnlyMemory<Char> créé à partir de cette instance StringBuilder.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Insert(Int32, Boolean)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'une valeur booléenne.

Insert(Int32, Byte)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé de 8 bits spécifié.

Insert(Int32, Char)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un caractère Unicode spécifié.

Insert(Int32, Char[])

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un tableau de caractères Unicode spécifié.

Insert(Int32, Char[], Int32, Int32)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un sous-tableau de caractères Unicode spécifié.

Insert(Int32, Decimal)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre décimal.

Insert(Int32, Double)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante double précision.

Insert(Int32, Int16)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 16 bits spécifié.

Insert(Int32, Int32)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 32 bits spécifié.

Insert(Int32, Int64)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé de 64 bits.

Insert(Int32, Object)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un objet.

Insert(Int32, ReadOnlySpan<Char>)

Insère la séquence de caractères dans cette instance, à la position de caractère spécifiée.

Insert(Int32, SByte)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier signé 8 bits spécifié.

Insert(Int32, Single)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un nombre à virgule flottante simple précision.

Insert(Int32, String)

Insère une chaîne dans cette instance, à la position de caractère spécifiée.

Insert(Int32, String, Int32)

Insère dans cette instance une ou plusieurs copies d'une chaîne spécifiée, à la position de caractère spécifiée.

Insert(Int32, UInt16)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 16 bits.

Insert(Int32, UInt32)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 32 bits.

Insert(Int32, UInt64)

Insère dans cette instance, à la position de caractère spécifiée, la représentation sous forme de chaîne d'un entier non signé 64 bits.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Remove(Int32, Int32)

Supprime de cette instance la plage de caractères spécifiée.

Replace(Char, Char)

Remplace toutes les occurrences d'un caractère spécifié dans cette instance par un autre caractère spécifié.

Replace(Char, Char, Int32, Int32)

Remplace toutes les occurrences d'un caractère spécifié dans une sous-chaîne de cette instance par un autre caractère spécifié.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Représente une chaîne de caractères mutable. Cette classe ne peut pas être héritée.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Représente une chaîne de caractères mutable. Cette classe ne peut pas être héritée.

Replace(String, String)

Remplace toutes les occurrences d'une chaîne spécifiée dans cette instance par une autre chaîne spécifiée.

Replace(String, String, Int32, Int32)

Remplace toutes les occurrences d'une chaîne spécifiée dans une sous-chaîne de cette instance par une autre chaîne spécifiée.

ToString()

Convertit la valeur de cette instance en String.

ToString(Int32, Int32)

Convertit la valeur d'une sous-chaîne de cette instance en String.

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un objet SerializationInfo avec les données nécessaires pour désérialiser l'objet StringBuilder actuel.

S’applique à

Voir aussi