Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método String.PadRight (Int32, Char)

 

Retorna uma nova String que alinha à esquerda os caracteres nesta String, preenchendo-a com um caractere Unicode especificado à direita, a fim de que a String atinja um comprimento total especificado.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public string PadRight(
	int totalWidth,
	char paddingChar
)

Parâmetros

totalWidth
Type: System.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
Type: System.Char

Um caractere de preenchimento de Unicode.

Valor Retornado

Type: System.String

Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à esquerda e preenchida à direita 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.

Exception Condition
ArgumentOutOfRangeException

totalWidth é menor que zero.

O PadRight(Int32, Char) método preenche o final da cadeia de caracteres retornada. Isso significa que, quando usada com idiomas da direita para esquerda, preencha a parte esquerda da cadeia de caracteres.

System_CAPS_noteObservação

Se o PadRight método preenche 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, ele retorna uma nova cadeia de caracteres que é preenchida com à direita paddingChar caracteres de forma que seu tamanho total é totalWidth caracteres.

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

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: