StringBuilder.Append Méthode

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

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

Surcharges

Nom	Description
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+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(UInt64)	Ajoute la représentation sous forme de chaîne d’un entier non signé 64 bits 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(Char*, Int32)	Ajoute un tableau de caractères Unicode commençant à une adresse spécifiée à cette instance.
Append(String)	Ajoute une copie de la chaîne spécifiée à 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(String, Int32, Int32)	Ajoute une copie d’une sous-chaîne spécifiée à 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(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(Single)	Ajoute la représentation sous forme de chaîne d’un nombre à virgule flottante simple précision 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(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(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 spécifié Char à 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(Char[])	Ajoute la représentation sous forme de chaîne des caractères Unicode dans un tableau 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(Int16)	Ajoute la représentation sous forme de chaîne d’un entier signé 16 bits spécifié à cette instance.

Append(StringBuilder)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(StringBuilder+AppendInterpolatedStringHandler)

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(UInt16)

Source:

StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt16) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• UInt16

Append(UInt64)

Source:

StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt64) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• UInt64

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(Char*, Int32)

Source:

StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS

System.Text.StringBuilder.Append(Char[], Int32, Int32)

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

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append(char* value, int valueCount);

[<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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

valueCount est inférieur à zéro.

- ou -

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

NullReferenceException

value est un pointeur Null.

Remarques

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

La Append(Char*, Int32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une nouvelle instance de classe. En raison de cela, 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Append(String)

Source:

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(String) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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.

Si value c’est le cas, aucune modification n’est nullapportée.

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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• String

Append(Char[], Int32, Int32)

Source:

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <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 en value.

charCount

Int32

Nombre de caractères à ajouter.

Retours

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentNullException

valueest null, et ne charCountstartIndex sont pas zéro.

ArgumentOutOfRangeException

charCount est inférieur à zéro.

- ou -

startIndex est inférieur à zéro.

- ou -

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

- ou -

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute la plage de caractères value spécifiée à l’instance actuelle. S’il value s’agit null et startIndexcount sont tous les deux zéros, aucune modification n’est apportée.

La Append(Char[], Int32, Int32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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', '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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Char

Append(String, Int32, Int32)

Source:

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::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 à value ajouter.

Retours

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentNullException

valueest null, et ne countstartIndex sont pas zéro.

ArgumentOutOfRangeException

count inférieur à zéro.

- ou -

startIndex inférieur à zéro.

- ou -

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

- ou -

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute la plage de caractères value spécifiée à l’instance actuelle. S’il value s’agit null et startIndexcount sont tous les deux zéros, aucune modification n’est apportée.

La Append(String, Int32, Int32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 = "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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• String

Append(StringBuilder, Int32, Int32)

Source:

StringBuilder.cs

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

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 à value ajouter.

Retours

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(Char, Int32)

Source:

StringBuilder.cs

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

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 de fois à ajouter value.

Retours

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

repeatCount est inférieur à zéro.

- ou -

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

OutOfMemoryException

Mémoire insuffisante.

Remarques

La Append(Char, Int32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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).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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Char

Append(Single)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Single) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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.

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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Single

Append(UInt32)

Source:

StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(UInt32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• UInt32

Append(ReadOnlySpan<Char>)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(SByte)

Source:

StringBuilder.cs

Important

Cette API n’est pas conforme CLS.

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(SByte) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• SByte

Append(Boolean)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Boolean) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Boolean

Append(Byte)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Byte) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Byte

Append(Char)

Source:

StringBuilder.cs

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

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 UTF-16 à ajouter.

Retours

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Char) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Char

Append(Decimal)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Decimal) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Decimal

Append(Double)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Double) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Double

Append(Char[])

Source:

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

Cette méthode ajoute tous les caractères du tableau spécifié à l’instance actuelle dans le même ordre qu’ils apparaissent dans value. Si value c’est le cas, aucune modification n’est nullapportée.

La Append(Char[]) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Append(Int32)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int32) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Int32

Append(Int64)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int64) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 la Int64.ToString(IFormatProvider) méthode pour obtenir la représentation sous forme de chaîne de value 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Int64

Append(Object)

Source:

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Object) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 méthode pour créer une chaîne qui contient le nom et la Append 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 c’est nullle cas, aucune modification n’est apporté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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Object

Append(ReadOnlyMemory<Char>)

Source:

StringBuilder.cs

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.

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Append(Int16)

Source:

StringBuilder.cs

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

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

StringBuilder

Référence à cette instance une fois l’opération d’ajout terminée.

Exceptions

ArgumentOutOfRangeException

L’agrandissement de la valeur de cette instance dépasserait MaxCapacity.

Remarques

La Append(Int16) méthode modifie l’instance existante de cette classe ; elle ne retourne pas une 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 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 en appelant le StringBuilderStringBuilder(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 méthodes et AppendFormat(String, Object) les Append(String) méthodes pour ajouter de petites chaînes.

Voir aussi

• Int16