String.PadRight Método

Definição

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

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

Sobrecargas

Name Description
PadRight(Int32)

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

Devolve uma nova cadeia que alinha à esquerda os caracteres dessa cadeia, preenchendo-os à direita com um carácter Unicode especificado, para um comprimento total especificado.

PadRight(Int32)

Devolve uma nova cadeia que alinha à esquerda os caracteres dessa cadeia, preenchendo-os com espaços à direita, para um comprimento total especificado.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight(int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (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 à esquerda e preenchida à direita 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 PadRight método.

string str;
str = "BBQ and Slaw";

Console.Write("|");
Console.Write(str.PadRight(15));
Console.WriteLine("|");       // Displays "|BBQ and Slaw   |".

Console.Write("|");
Console.Write(str.PadRight(5));
Console.WriteLine("|");       // Displays "|BBQ and Slaw|".

let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // Displays "|BBQ and Slaw|".

Dim str As String
str = "BBQ and Slaw"

Console.Write("|")
Console.Write(str.PadRight(15))
Console.WriteLine("|") ' Displays "|BBQ and Slaw   |".

Console.Write("|")
Console.Write(str.PadRight(5))
Console.WriteLine("|") ' Displays "|BBQ and Slaw|".

Observações

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

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

Note

Se o PadRight 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ço branco final para que o seu comprimento total seja em totalWidth caracteres.

Ver também

Aplica-se a

PadRight(Int32, Char)

Devolve uma nova cadeia que alinha à esquerda os caracteres dessa cadeia, preenchendo-os à direita com um carácter Unicode especificado, para um comprimento total especificado.

public:
 System::String ^ PadRight(int totalWidth, char paddingChar);
public string PadRight(int totalWidth, char paddingChar);
member this.PadRight : int * char -> string
Public Function PadRight (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 à esquerda e preenchida à direita 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 PadRight método.

string str = "forty-two";
char pad = '.';

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

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

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{str.PadRight(2, pad)}"    // Displays "forty-two".

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

Observações

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

Note

Se o PadRight 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 finais paddingChar para que o seu comprimento total seja totalWidth caracteres.

Ver também

Aplica-se a