String.PadRight Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retourne une nouvelle chaîne d’une longueur spécifiée dans laquelle la fin de la chaîne actuelle est rembourrée avec des espaces ou avec un caractère Unicode spécifié.

Surcharges

Nom Description
PadRight(Int32)

Retourne une nouvelle chaîne qui aligne à gauche les caractères de cette chaîne en les paginant avec des espaces à droite, pour une longueur totale spécifiée.
PadRight(Int32, Char)

Retourne une nouvelle chaîne qui aligne à gauche les caractères de cette chaîne en les paginant à droite avec un caractère Unicode spécifié, pour une longueur totale spécifiée.

PadRight(Int32)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Retourne une nouvelle chaîne qui aligne à gauche les caractères de cette chaîne en les paginant avec des espaces à droite, pour une longueur totale spécifiée.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight(int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (totalWidth As Integer) As String

Paramètres

totalWidth
Int32

Nombre de caractères dans la chaîne résultante, égal au nombre de caractères d’origine, ainsi qu’à tous les caractères de remplissage supplémentaires.

Retours

String

Nouvelle chaîne équivalente à cette instance, mais alignée à gauche et rembourrée à droite avec autant d’espaces que nécessaire pour créer une longueur de totalWidth. Toutefois, si totalWidth elle est inférieure à la longueur de cette instance, la méthode retourne une référence à l’instance existante. Si totalWidth elle est égale à la longueur de cette instance, la méthode retourne une nouvelle chaîne identique à cette instance.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadRight méthode.

string str;
str = "BBQ and Slaw";

Console.Write("|");
Console.Write(str.PadRight(15));
Console.WriteLine("|");       // Displays "|BBQ and Slaw   |".

Console.Write("|");
Console.Write(str.PadRight(5));
Console.WriteLine("|");       // Displays "|BBQ and Slaw|".

let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // Displays "|BBQ and Slaw|".

Dim str As String
str = "BBQ and Slaw"

Console.Write("|")
Console.Write(str.PadRight(15))
Console.WriteLine("|") ' Displays "|BBQ and Slaw   |".

Console.Write("|")
Console.Write(str.PadRight(5))
Console.WriteLine("|") ' Displays "|BBQ and Slaw|".

Remarques

Un espace Unicode est défini comme 0x0020 hexadécimal.

La PadRight(Int32) méthode pads la fin de la chaîne retournée. Cela signifie que, lorsqu’elle est utilisée avec des langues de droite à gauche, elle pavée la partie gauche de la chaîne.

Note

Si la méthode padse l’instance PadRight actuelle avec des caractères d’espace blanc, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne qui est rembourrée avec un espace blanc de fin afin que sa longueur totale soit totalWidth des caractères.

Voir aussi

S’applique à

PadRight(Int32, Char)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Retourne une nouvelle chaîne qui aligne à gauche les caractères de cette chaîne en les paginant à droite avec un caractère Unicode spécifié, pour une longueur totale spécifiée.

public:
 System::String ^ PadRight(int totalWidth, char paddingChar);
public string PadRight(int totalWidth, char paddingChar);
member this.PadRight : int * char -> string
Public Function PadRight (totalWidth As Integer, paddingChar As Char) As String

Paramètres

totalWidth
Int32

Nombre de caractères dans la chaîne résultante, égal au nombre de caractères d’origine, ainsi qu’à tous les caractères de remplissage supplémentaires.

paddingChar
Char

Caractère de remplissage Unicode.

Retours

String

Nouvelle chaîne équivalente à cette instance, mais alignée à gauche et rembourrée à droite avec autant de paddingChar caractères que nécessaire pour créer une longueur de totalWidth. Toutefois, si totalWidth elle est inférieure à la longueur de cette instance, la méthode retourne une référence à l’instance existante. Si totalWidth elle est égale à la longueur de cette instance, la méthode retourne une nouvelle chaîne identique à cette instance.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadRight méthode.

string str = "forty-two";
char pad = '.';

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

let str = "forty-two"
let pad = '.'

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{str.PadRight(2, pad)}"    // Displays "forty-two".

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

Remarques

La PadRight(Int32, Char) méthode pads la fin de la chaîne retournée. Cela signifie que, lorsqu’elle est utilisée avec des langues de droite à gauche, elle pavée la partie gauche de la chaîne.

Note

Si la méthode padse l’instance PadRight actuelle avec des caractères d’espace blanc, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne qui est remplie de caractères de paddingChar fin afin que sa longueur totale soit totalWidth des caractères.

Voir aussi

S’applique à