String.PadLeft Méthode

  • Référence

Définition

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

Retourne une nouvelle chaîne d'une longueur spécifiée dans laquelle le début de la chaîne actuelle est complété par des espaces ou un caractère Unicode spécifié.

Surcharges

PadLeft(Int32)

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

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

PadLeft(Int32)

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

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

Paramètres

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

Retours

String

Nouvelle chaîne équivalant à cette instance, mais alignée à droite et complétée à gauche 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.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadLeft méthode.

String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) );  // Displays "BBQ and Slaw".

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".

Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Remarques

Un espace Unicode est défini en tant que 0x0020 hexadécimal.

La PadLeft(Int32) méthode remplit le début de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langues de droite à gauche, il remplit la partie droite de la chaîne.

Notes

Si la PadLeft méthode remplit l’instance actuelle avec des espaces blancs, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne remplie avec un espace blanc de début, de sorte que sa longueur totale est de totalWidth caractères.

Voir aussi

S’applique à

PadLeft(Int32, Char)

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

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

Paramètres

totalWidth
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
Char

Caractère Unicode de remplissage.

Retours

String

Nouvelle chaîne équivalant à cette instance, mais alignée à droite et complétée à gauche 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.

Exceptions

ArgumentOutOfRangeException

totalWidth est inférieur à zéro.

Exemples

L’exemple suivant illustre la PadLeft méthode.

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two

using System;

class Sample
{
   public static void Main()
   {
   string str = "forty-two";
   char pad = '.';

   Console.WriteLine(str.PadLeft(15, pad));
   Console.WriteLine(str.PadLeft(2, pad));
   }
}
// The example displays the following output:
//       ......forty-two
//       forty-two

Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Remarques

La PadLeft(Int32, Char) méthode remplit le début de la chaîne retournée. Cela signifie que, lorsqu’il est utilisé avec des langues de droite à gauche, il remplit la partie droite de la chaîne.

Notes

Si la PadLeft méthode remplit l’instance actuelle avec des espaces blancs, cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne remplie avec des paddingChar caractères de début afin que sa longueur totale soit de totalWidth caractères.

Voir aussi

S’applique à