StringBuilder.Append Méthode

Référence

Définition

Espace de noms:: System.Text

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

StringBuilder

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

StringBuilder

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

StringBuilder

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

Attributs: CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

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

UInt16

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

StringBuilder

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

Attributs: CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

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

Voir aussi

UInt32

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

repeatCount est inférieur à zéro.

- ou -

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

OutOfMemoryException

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

Voir aussi

Char

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

StringBuilder

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

Exceptions

ArgumentNullException

value a la valeur null, tandis que startIndex et charCount sont différents de 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 -

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

Voir aussi

Char

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

StringBuilder

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Voir aussi

String

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

StringBuilder

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

Exceptions

ArgumentNullException

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

ArgumentOutOfRangeException

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

Voir aussi

String

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

StringBuilder

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

StringBuilder

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

Attributs: CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentOutOfRangeException

valueCount est inférieur à zéro.

- ou -

Une augmentation 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 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

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Voir aussi

Single

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

StringBuilder

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

Attributs: CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

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

Voir aussi

UInt64

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

StringBuilder

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

StringBuilder

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

Attributs: CLSCompliantAttribute

Exceptions

ArgumentOutOfRangeException

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

Voir aussi

SByte

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Boolean

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Byte

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Char

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Decimal

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Double

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Int16

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Int32

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Int64

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

StringBuilder

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

Exceptions

ArgumentOutOfRangeException

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

Object

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

StringBuilder

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

S’applique à

Partage via

StringBuilder.Append Méthode

Définition

Surcharges

Append(StringBuilder)

Paramètres

Retours

S’applique à

Append(StringBuilder+AppendInterpolatedStringHandler)

Paramètres

Retours

S’applique à

Append(UInt16)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(UInt32)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(Char, Int32)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(Char[], Int32, Int32)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Paramètres

Retours

S’applique à

Append(String)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(String, Int32, Int32)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Append(StringBuilder, Int32, Int32)

Paramètres

Retours

S’applique à

Append(Char*, Int32)

Paramètres

Retours

Exceptions

Remarques

Notes pour les appelants

S’applique à

Append(Single)

Paramètres

Retours

Exceptions

Remarques