String.PadLeft 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 le début de la chaîne actuelle est rembourré avec des espaces ou avec un caractère Unicode spécifié.

Surcharges

Nom Description
PadLeft(Int32)

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

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

PadLeft(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 à droite les caractères de cette instance en les remplissages avec des espaces sur la 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 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 à droite et rembourrée sur la gauche 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 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".

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{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 comme 0x0020 hexadécimal.

La PadLeft(Int32) méthode pavée le début 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 droite de la chaîne.

Note

Si la méthode padse l’instance PadLeft 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 début afin que sa longueur totale soit totalWidth des caractères.

Voir aussi

S’applique à

PadLeft(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 à droite les caractères de cette instance en les paginant à gauche avec un caractère Unicode spécifié, 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 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 à droite et rembourrée à gauche 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 PadLeft méthode.

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

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

printfn $"{str.PadLeft(15, pad)}"
printfn $"{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 pavée le début 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 droite de la chaîne.

Note

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

Voir aussi

S’applique à