Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

String.PadRight, méthode (Int32)

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

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

public string PadRight(
	int totalWidth
)

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.

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

ExceptionCondition
ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

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

La méthode PadRight(Int32) remplit la fin de la chaîne retournée. Cela signifie que, lorsqu'elle est utilisée avec les langues s'écrivant de droite à gauche, elle remplit la partie gauche de la chaîne.

RemarqueRemarque

Cette méthode ne modifie pas la valeur de l'instance actuelle. Elle retourne une nouvelle chaîne remplie par des espaces de fin de façon à ce que sa longueur totale corresponde aux caractères totalWidth.

L'exemple de code suivant illustre la méthode PadRight.


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|".


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft