String.PadLeft Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

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

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 alguns caracteres de preenchimento adicionais.

Retornos

String

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

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

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

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 preencha a parte direita da cadeia de caracteres.

Observação

Se o PadLeft método preencha 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 o espaço em branco à esquerda para que seu comprimento total seja de totalWidth caracteres.

Confira também

• Int32
• PadRight(Int32)
• Trim(Char[])

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.

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 alguns caracteres de preenchimento adicionais.

paddingChar

Char

Um caractere de preenchimento de Unicode.

Retornos

String

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

ArgumentOutOfRangeException

totalWidth é menor que zero.

Exemplos

O exemplo a seguir demonstra o PadLeft método.

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

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 preencha a parte direita da cadeia de caracteres.

Observação

Se o PadLeft método preencha 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 o comprimento total seja de totalWidth caracteres.

Confira também

• Char
• Int32
• PadRight(Int32)
• Trim(Char[])