String.PadLeft Método

Definição

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retorna uma nova cadeia de caracteres de um comprimento especificado no qual o início da cadeia de caracteres atual é acolchoado com espaços ou com um caractere Unicode especificado.

Sobrecargas

Nome Description
PadLeft(Int32)

Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nesta instância, preenchendo-os com espaços à esquerda, para um comprimento total especificado.
PadLeft(Int32, Char)

Retorna uma nova cadeia de caracteres que alinha à direita os caracteres nesta instância, preenchendo-os à esquerda com um caractere Unicode especificado, para um comprimento total especificado.

PadLeft(Int32)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Retorna uma nova cadeia de caracteres que alinha os caracteres à direita nesta instância, preenchendo-os com espaços à esquerda, para um comprimento total especificado.

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

Parâmetros

totalWidth
Int32

O número de caracteres na cadeia de caracteres resultante, igual ao número de caracteres originais mais quaisquer caracteres de preenchimento adicionais.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à direita e acolchoada à esquerda com quantos espaços forem necessários para criar um comprimento de totalWidth. No entanto, se totalWidth for menor que o comprimento dessa instância, o método retornará uma referência à instância existente. Se totalWidth for igual ao comprimento dessa instância, o método retornará uma nova cadeia de caracteres idêntica a essa instância.

Exceções

ArgumentOutOfRangeException

totalWidth é menor que zero.

Exemplos

O exemplo a seguir demonstra o PadLeft método.

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

Comentários

Um espaço Unicode é definido como 0x0020 hexadecimal.

O PadLeft(Int32) método acompanha o início da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele armazena a parte direita da cadeia de caracteres.

Note

Se o PadLeft método contém a instância atual com caracteres de espaço em branco, esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres que é adicionada com espaço em branco à esquerda para que seu comprimento total seja totalWidth de caracteres.

Confira também

Aplica-se a

PadLeft(Int32, Char)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Retorna uma nova cadeia de caracteres que alinha à direita os caracteres nesta instância, preenchendo-os à esquerda com um caractere Unicode especificado, para um comprimento total especificado.

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

Parâmetros

totalWidth
Int32

O número de caracteres na cadeia de caracteres resultante, igual ao número de caracteres originais mais quaisquer caracteres de preenchimento adicionais.

paddingChar
Char

Um caractere de preenchimento Unicode.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à direita e acolchoada à esquerda com quantos caracteres paddingChar forem necessários para criar um comprimento de totalWidth. No entanto, se totalWidth for menor que o comprimento dessa instância, o método retornará uma referência à instância existente. Se totalWidth for igual ao comprimento dessa instância, o método retornará uma nova cadeia de caracteres idêntica a essa instância.

Exceções

ArgumentOutOfRangeException

totalWidth é menor que zero.

Exemplos

O exemplo a seguir demonstra o PadLeft método.

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

Comentários

O PadLeft(Int32, Char) método acompanha o início da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele armazena a parte direita da cadeia de caracteres.

Note

Se o PadLeft método contém a instância atual com caracteres de espaço em branco, esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres que é acolchoada com caracteres principais paddingChar para que seu comprimento total seja totalWidth de caracteres.

Confira também

Aplica-se a