Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

String.PadRight méthode (Int32, Char)

 

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

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public string PadRight(
	int totalWidth,
	char paddingChar
)

Paramètres

totalWidth
Type: System.Int32

Nombre de caractères dans la chaîne qui en résulte, égal au nombre de caractères d'origine plus tout caractère de remplissage supplémentaire.

paddingChar
Type: System.Char

Caractère Unicode de remplissage.

Valeur de retour

Type: System.String

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

Exception Condition
ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

The M:System.String.PadRight(System.Int32,System.Char) method pads the end of the returned string. This means that, when used with right-to-left languages, it pads the left portion of the string.

System_CAPS_noteRemarque

If the M:System.String.PadRight(System.Int32) method pads the current instance with whitespace characters, this method does not modify the value of the current instance. Instead, it returns a new string that is padded with trailing paddingChar characters so that its total length is totalWidth characters.

The following example demonstrates the M:System.String.PadRight(System.Int32) method.

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

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: