StringBuilder Classe

Définition

Représente une chaîne mutable de caractères. 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 un grand nombre de méthodes définies par la classe 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

Remarques

Pour plus d’informations sur cette API, consultez remarques sur l’API supplémentaire 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 constructeur StringBuilder(Int32, Int32), la longueur et la capacité de l’instance StringBuilder peuvent augmenter au-delà de la valeur de sa propriété MaxCapacity. Cela peut se produire en particulier lorsque vous appelez les méthodes Append(String) 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 à l’aide de la capacité spécifiée.

StringBuilder(Int32, Int32)

Initialise une nouvelle instance de la classe StringBuilder qui commence par une capacité spécifiée et peut atteindre 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 à l’aide de la chaîne et de 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 pouvant être contenus dans la mémoire allouée par l’instance actuelle.

Chars[Int32]

Obtient ou définit le caractère à 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 la représentation sous forme de chaîne d’une valeur booléenne spécifiée à cette instance.

Append(Byte)

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

Append(Char)

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

Append(Char*, Int32)

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

Append(Char, Int32)

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

Append(Char[])

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

Append(Char[], Int32, Int32)

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

Append(Decimal)

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

Append(Double)

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

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

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

Append(Int16)

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

Append(Int32)

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

Append(Int64)

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

Append(Object)

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

Append(ReadOnlyMemory<Char>)

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

Append(ReadOnlySpan<Char>)

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

Append(SByte)

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

Append(Single)

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

Append(String)

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

Append(String, Int32, Int32)

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

Append(StringBuilder)

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

Append(StringBuilder, Int32, Int32)

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

Append(StringBuilder+AppendInterpolatedStringHandler)

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

Append(UInt16)

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

Append(UInt32)

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

Append(UInt64)

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

AppendFormat(IFormatProvider, CompositeFormat, Object[])

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. 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 la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. 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 la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un seul argument à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object, Object)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des deux arguments à l’aide d’un fournisseur de format spécifié.

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

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des trois arguments à l’aide d’un fournisseur de format spécifié.

AppendFormat(IFormatProvider, String, Object[])

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format 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(IFormatProvider, String, ReadOnlySpan<Object>)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un argument correspondant dans une étendue de paramètre à l’aide d’un fournisseur de format spécifié.

AppendFormat(String, Object)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un seul argument.

AppendFormat(String, Object, Object)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des deux arguments.

AppendFormat(String, Object, Object, Object)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne de l’un des trois arguments.

AppendFormat(String, Object[])

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un argument correspondant dans un tableau de paramètres.

AppendFormat(String, ReadOnlySpan<Object>)

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. Chaque élément de format est remplacé par la représentation sous forme de chaîne d’un argument correspondant dans une étendue de paramètre.

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

Ajoute la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. 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 la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. 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 la chaîne retournée en traitant une chaîne de format composite, qui contient zéro ou plusieurs éléments de format, à cette instance. 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, à l’aide du 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, ReadOnlySpan<Object>)

Concatène les représentations sous forme de chaîne des éléments dans l’étendue d’objets fournie, à l’aide du 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, ReadOnlySpan<String>)

Concatène les chaînes de l’étendue fournie, à l’aide du 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(Char, String[])

Concatène les chaînes du tableau fourni, à l’aide du 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, à l’aide du séparateur spécifié entre chaque membre, puis ajoute le résultat à l’instance actuelle du générateur de chaînes.

AppendJoin(String, ReadOnlySpan<Object>)

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

AppendJoin(String, ReadOnlySpan<String>)

Concatène les chaînes de l’étendue fournie, à l’aide du séparateur spécifié entre chaque chaîne, 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 à l’aide du 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 à l’aide du séparateur de caractères spécifié entre chaque membre.

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

Concatène et ajoute les membres d’une collection à l’aide du séparateur spécifié entre chaque membre.

AppendLine()

Ajoute le terminateur 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 à l’aide du format spécifié, suivi de l’indicateur de 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 l’indicateur 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 de l’indicateur de fin de ligne par défaut à la fin de l’objet StringBuilder actuel.

Clear()

Supprime tous les caractères de l’instance de 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 vers une étendue de Char de destination.

EnsureCapacity(Int32)

Garantit que la capacité de cette instance de StringBuilder est au moins 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 aux caractères d’une étendue de caractères en lecture seule spécifiée.

Equals(StringBuilder)

Retourne une valeur indiquant si cette instance est égale à 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()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

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

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

Insert(Int32, Byte)

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

Insert(Int32, Char)

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

Insert(Int32, Char[])

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

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

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

Insert(Int32, Decimal)

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

Insert(Int32, Double)

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

Insert(Int32, Int16)

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

Insert(Int32, Int32)

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

Insert(Int32, Int64)

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

Insert(Int32, Object)

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

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 la représentation sous forme de chaîne d’un entier signé 8 bits spécifié dans cette instance à la position de caractère spécifiée.

Insert(Int32, Single)

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

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 une ou plusieurs copies d’une chaîne spécifiée dans cette instance à la position de caractère spécifiée.

Insert(Int32, UInt16)

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

Insert(Int32, UInt32)

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

Insert(Int32, UInt64)

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

MemberwiseClone()

Crée une copie superficielle du Objectactuel.

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

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

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, dans une sous-chaîne de cette instance, toutes les occurrences d’un caractère spécifié par un autre caractère spécifié.

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

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans ce générateur.

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

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans le cadre de ce générateur.

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, dans une sous-chaîne de cette instance, toutes les occurrences d’une chaîne spécifiée 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.

Méthodes d’extension

Append(StringBuilder, StringSegment)

Ajoutez le StringSegment donné au StringBuilder.

AppendRedacted(StringBuilder, Redactor, ReadOnlySpan<Char>)

Réacte les données potentiellement sensibles et les ajoute à une instance de StringBuilder.

AppendRedacted(StringBuilder, Redactor, String)

Réacte les données potentiellement sensibles et les ajoute à une instance de StringBuilder.

S’applique à

Voir aussi