Ler em inglês

Partilhar via


String.PadLeft Método

Definição

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

Sobrecargas

PadLeft(Int32, Char)

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

PadLeft(Int32)

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

PadLeft(Int32, Char)

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

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

C#
public string PadLeft (int totalWidth, char paddingChar);

Parâmetros

totalWidth
Int32

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

paddingChar
Char

Um caractere de preenchimento de Unicode.

Retornos

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

Exceções

totalWidth é menor que zero.

Exemplos

O exemplo a seguir demonstra o PadLeft método.

C#
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

Comentários

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

Nota

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

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

PadLeft(Int32)

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

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

C#
public string PadLeft (int totalWidth);

Parâmetros

totalWidth
Int32

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

Retornos

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

Exceções

totalWidth é menor que zero.

Exemplos

O exemplo a seguir demonstra o PadLeft método.

C#
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 preenche o início da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele preenche a parte direita da cadeia de caracteres.

Nota

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

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0