Partager via


StringBuilder.Append Méthode

Définition

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

Surcharges

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+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(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[], Int32, Int32)

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

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Ajoute la chaîne interpolée spécifiée à cette instance à l’aide du format 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, Int32, Int32)

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

Append(Char*, Int32)

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

Append(Single)

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

Append(UInt64)

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

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(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(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(Char[])

Ajoute à cette instance la représentation sous forme de chaîne des caractères Unicode d'un tableau 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(StringBuilder)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);
member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder
Public Function Append (value As StringBuilder) As StringBuilder

Paramètres

value
StringBuilder

Générateur de chaînes à ajouter.

Retours

Référence à cette instance après l’opération d’ajout.

S’applique à

Append(StringBuilder+AppendInterpolatedStringHandler)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Paramètres

handler
StringBuilder.AppendInterpolatedStringHandler

Chaîne interpolée à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

S’applique à

Append(UInt16)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);
[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder
Public Function Append (value As UShort) As StringBuilder

Paramètres

value
UInt16

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Attributs

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt16) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

La Append(UInt16) méthode appelle la UInt16.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(UInt32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);
[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder
Public Function Append (value As UInteger) As StringBuilder

Paramètres

value
UInt32

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Attributs

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt32) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

Appelle Append(UInt32) la UInt32.ToString méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(Char, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);
public System.Text.StringBuilder Append (char value, int repeatCount);
member this.Append : char * int -> System.Text.StringBuilder
Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Paramètres

value
Char

Caractère à ajouter.

repeatCount
Int32

Nombre d'ajouts de value.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

repeatCount est inférieur à zéro.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Mémoire insuffisante.

Remarques

La Append(Char, Int32) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****$1,346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****$1,346.19*****

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(Char[], Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[]? value, int startIndex, int charCount);
member this.Append : char[] * int * int -> System.Text.StringBuilder
Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Paramètres

value
Char[]

Tableau de caractères.

startIndex
Int32

Position de départ dans value.

charCount
Int32

Nombre de caractères à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

value a la valeur null, tandis que startIndex et charCount sont différents de zéro.

charCount est inférieur à zéro.

- ou -

startIndex est inférieur à zéro.

- ou -

startIndex + charCount est supérieur à la longueur de value.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute la plage de caractères spécifiée dans value au instance actuel. Si value et sont count tous les deux zéros, aucune modification n’est nullstartIndex apportée.

La Append(Char[], Int32, Int32) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{sb}"
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.
Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' The example displays the following output:
'       The array from positions 0 to 2 contains abc.

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Paramètres

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

handler
StringBuilder.AppendInterpolatedStringHandler

Chaîne interpolée à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

S’applique à

Append(String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (string value);
public System.Text.StringBuilder Append (string? value);
member this.Append : string -> System.Text.StringBuilder
Public Function Append (value As String) As StringBuilder

Paramètres

value
String

Chaîne à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(String) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

Si value a la valeur , aucune modification n’est nullapportée.

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(String, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (string value, int startIndex, int count);
public System.Text.StringBuilder Append (string? value, int startIndex, int count);
member this.Append : string * int * int -> System.Text.StringBuilder
Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

Paramètres

value
String

Chaîne qui contient la sous-chaîne à ajouter.

startIndex
Int32

Position de départ de la sous-chaîne dans value.

count
Int32

Nombre de caractères de value à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

value a la valeur null, tandis que startIndex et count sont différents de zéro.

count est inférieur à zéro.

- ou -

startIndex est inférieur à zéro.

- ou -

startIndex + count est supérieur à la longueur de value.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute la plage de caractères spécifiée dans value au instance actuel. Si value et sont count tous les deux zéros, aucune modification n’est nullstartIndex apportée.

La Append(String, Int32, Int32) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797
let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{sb}"
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797
Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(" to ")
index += length + 1
sb.Append(str, index, str.Length - index)
Console.WriteLine(sb)
' The example displays the following output:
'    First President of the United States: George Washington, from 1789 to 1797

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(StringBuilder, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);
member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder
Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

Paramètres

value
StringBuilder

Générateur de chaînes qui contient la sous-chaîne à ajouter.

startIndex
Int32

Position de départ de la sous-chaîne dans value.

count
Int32

Nombre de caractères de value à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

S’applique à

Append(Char*, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

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

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Paramètres

value
Char*

Pointeur vers un tableau de caractères.

valueCount
Int32

Nombre de caractères dans le tableau.

Retours

Référence à cette instance après l'opération d'ajout.

Attributs

Exceptions

valueCount est inférieur à zéro.

- ou -

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

value est un pointeur Null.

Remarques

Cette méthode ajoute des valueCount caractères commençant à l’adresse value au instance actuel.

La Append(Char*, Int32) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet.

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

S’applique à

Append(Single)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(float value);
public System.Text.StringBuilder Append (float value);
member this.Append : single -> System.Text.StringBuilder
Public Function Append (value As Single) As StringBuilder

Paramètres

value
Single

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Single) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

La Append(Single) méthode appelle la Single.ToString méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(UInt64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);
[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder
Public Function Append (value As ULong) As StringBuilder

Paramètres

value
UInt64

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Attributs

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt64) méthode modifie la instance existante de cette classe ; elle ne retourne pas de nouvelle classe instance. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

La Append(UInt64) méthode appelle la UInt64.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de ce instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(ReadOnlySpan<Char>)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);
public System.Text.StringBuilder Append (ReadOnlySpan<char> value);
member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

Paramètres

value
ReadOnlySpan<Char>

Étendue de caractères en lecture seule à ajouter.

Retours

Référence à cette instance après l’opération d’ajout.

S’applique à

Append(SByte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

public:
 System::Text::StringBuilder ^ Append(System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);
[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder
Public Function Append (value As SByte) As StringBuilder

Paramètres

value
SByte

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Attributs

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(SByte) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127

La Append(SByte) méthode appelle la SByte.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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é du StringBuilder instance 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.

Voir aussi

S’applique à

Append(Boolean)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(bool value);
public System.Text.StringBuilder Append (bool value);
member this.Append : bool -> System.Text.StringBuilder
Public Function Append (value As Boolean) As StringBuilder

Paramètres

value
Boolean

Valeur booléenne à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Boolean) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

La Append(Boolean) méthode appelle la Boolean.ToString() méthode pour obtenir la représentation sous forme de chaîne de value. La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Byte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Byte value);
public System.Text.StringBuilder Append (byte value);
member this.Append : byte -> System.Text.StringBuilder
Public Function Append (value As Byte) As StringBuilder

Paramètres

value
Byte

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Byte) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253
let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// The example displays the following output:
//         The byte array: 16 132 27 253
Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253

La Append(Byte) méthode appelle la ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Char)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(char value);
public System.Text.StringBuilder Append (char value);
member this.Append : char -> System.Text.StringBuilder
Public Function Append (value As Char) As StringBuilder

Paramètres

value
Char

Unité de code encodée en UTF-16 à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Char) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'
let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {sb}"
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'
Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Decimal)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);
public System.Text.StringBuilder Append (decimal value);
member this.Append : decimal -> System.Text.StringBuilder
Public Function Append (value As Decimal) As StringBuilder

Paramètres

value
Decimal

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Decimal) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

La Append(Decimal) méthode appelle la Decimal.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Double)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(double value);
public System.Text.StringBuilder Append (double value);
member this.Append : double -> System.Text.StringBuilder
Public Function Append (value As Double) As StringBuilder

Paramètres

value
Double

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Double) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

La Append(Double) méthode appelle la Double.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Char[])

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
public System.Text.StringBuilder Append (char[] value);
public System.Text.StringBuilder Append (char[]? value);
member this.Append : char[] -> System.Text.StringBuilder
Public Function Append (value As Char()) As StringBuilder

Paramètres

value
Char[]

Tableau de caractères à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute tous les caractères du tableau spécifié au instance actuel dans le même ordre qu’ils apparaissent dans value. Si value a la valeur , aucune modification n’est nullapportée.

La Append(Char[]) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

char[] chars = { 'a', 'e', 'i', 'o', 'u' };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The characters in the array: ").Append(chars);
Console.WriteLine(sb);
// The example displays the following output:
//      The characters in the array: aeiou
let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{sb}"
// The example displays the following output:
//      The characters in the array: aeiou
Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c }
Dim sb As New System.Text.StringBuilder()
sb.Append("The characters in the array: ").Append(chars)
Console.WriteLine(sb)
' The example displays the following output:
'      The characters in the array: aeiou

La capacité de cette instance est ajustée en fonction des besoins.

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.

S’applique à

Append(Int16)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(short value);
public System.Text.StringBuilder Append (short value);
member this.Append : int16 -> System.Text.StringBuilder
Public Function Append (value As Short) As StringBuilder

Paramètres

value
Int16

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int16) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

La Append(Int16) méthode appelle la Int16.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(int value);
public System.Text.StringBuilder Append (int value);
member this.Append : int -> System.Text.StringBuilder
Public Function Append (value As Integer) As StringBuilder

Paramètres

value
Int32

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int32) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

La Append(Int32) méthode appelle la Int32.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Int64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(long value);
public System.Text.StringBuilder Append (long value);
member this.Append : int64 -> System.Text.StringBuilder
Public Function Append (value As Long) As StringBuilder

Paramètres

value
Int64

Valeur à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int64) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

La Append(Int64) méthode appelle le Int64.ToString(IFormatProvider) pour obtenir la représentation sous forme de chaîne de value pour la culture actuelle. Pour contrôler la mise en forme de value, appelez la AppendFormat méthode .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(Object)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (object value);
public System.Text.StringBuilder Append (object? value);
member this.Append : obj -> System.Text.StringBuilder
Public Function Append (value As Object) As StringBuilder

Paramètres

value
Object

Objet à ajouter.

Retours

Référence à cette instance après l'opération d'ajout.

Exceptions

Une augmentation de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Object) méthode modifie les instance existantes de cette classe ; elle ne retourne pas de nouvelle instance de classe. Pour cette raison, vous pouvez appeler une méthode ou une propriété sur la référence existante et vous n’avez pas besoin d’affecter la valeur de retour à un StringBuilder objet, comme l’illustre l’exemple suivant. Il définit une Dog classe, crée un Dog objet et effectue trois appels à la Append méthode pour créer une chaîne qui contient le nom et la race du chien.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute
Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

La Append(Object) méthode appelle la Object.ToString méthode pour obtenir la représentation sous forme de chaîne de value. Si value a la valeur , aucune modification n’est nullapportée à l’objet StringBuilder .

La capacité de cette instance est ajustée en fonction des besoins.

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.

Voir aussi

S’applique à

Append(ReadOnlyMemory<Char>)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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.

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);
public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);
member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Paramètres

value
ReadOnlyMemory<Char>

Région de mémoire de caractères en lecture seule à ajouter.

Retours

Référence à cette instance après l’opération d’ajout.

S’applique à