String.PadLeft Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Devolve uma nova cadeia de um comprimento especificado em que o início da cadeia atual é preenchido com espaços ou com um carácter Unicode especificado.

Sobrecargas

Name Description
PadLeft(Int32)

Devolve uma nova cadeia que alinha os caracteres à direita neste caso, preenchendo-os com espaços à esquerda, para um comprimento total especificado.
PadLeft(Int32, Char)

Devolve uma nova cadeia que alinha os caracteres à direita neste caso, preenchendo-os à esquerda com um carácter 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

Devolve uma nova cadeia que alinha os caracteres à direita neste caso, 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 resultante, igual ao número de caracteres originais mais quaisquer caracteres adicionais de preenchimento (padding characters).

Devoluções

String

Uma nova cadeia que é equivalente a esta instância, mas alinhada à direita e preenchida à esquerda com tantos espaços quanto necessário para criar um comprimento de totalWidth. No entanto, se totalWidth for inferior ao comprimento desta instância, o método devolve uma referência à instância existente. Se totalWidth for igual ao comprimento desta instância, o método devolve uma nova cadeia idêntica a esta instância.

Exceções

ArgumentOutOfRangeException

totalWidth é inferior a zero.

Exemplos

O exemplo seguinte 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".

Observações

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

O PadLeft(Int32) método preenche o início da corda devolvida. Isto significa que, quando usado com línguas da direita para a esquerda, preenche a parte direita da cadeia.

Note

Se o PadLeft método preencher a instância atual com caracteres de espaço em branco, este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia que é preenchida com espaços brancos à esquerda, de modo que o seu comprimento total seja em totalWidth caracteres.

Ver 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

Devolve uma nova cadeia que alinha os caracteres à direita neste caso, preenchendo-os à esquerda com um carácter 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 resultante, igual ao número de caracteres originais mais quaisquer caracteres adicionais de preenchimento (padding characters).

paddingChar
Char

Um carácter de enchimento Unicode.

Devoluções

String

Uma nova cadeia que é equivalente a esta instância, mas alinhada à direita e preenchida à esquerda com tantos paddingChar caracteres quanto necessário para criar um comprimento de totalWidth. No entanto, se totalWidth for inferior ao comprimento desta instância, o método devolve uma referência à instância existente. Se totalWidth for igual ao comprimento desta instância, o método devolve uma nova cadeia idêntica a esta instância.

Exceções

ArgumentOutOfRangeException

totalWidth é inferior a zero.

Exemplos

O exemplo seguinte 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

Observações

O PadLeft(Int32, Char) método preenche o início da corda devolvida. Isto significa que, quando usado com línguas da direita para a esquerda, preenche a parte direita da cadeia.

Note

Se o PadLeft método preencher a instância atual com caracteres de espaço em branco, este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia que é preenchida com caracteres iniciais paddingChar , de modo que o seu comprimento total seja totalWidth em caracteres.

Ver também

Aplica-se a