Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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
Tipo: 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
Tipo: System.Char
Um caractere de preenchimento Unicode.

Valor de retorno

Tipo: System.String
Uma nova cadeia de caracteres que é equivalente a esta instância, mas à esquerda e à direita preenchido com tantos caracteres de paddingChar quando necessário criar um comprimento de totalWidth. No entanto, se totalWidth for menor que o comprimento dessa instância, o método retorna 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çãoCondição
ArgumentOutOfRangeException

totalWidth é menor que zero.

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

ObservaçãoObservação

Este método não altera o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres que é preenchida com arraste de caracteres de paddingChar de modo que o comprimento total é caracteres de totalWidth .

O exemplo a seguir demonstra o método de PadRight .


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

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


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft