String.PadRight Método

Definição

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retorna uma nova cadeia de caracteres de um comprimento especificado no qual o final da cadeia de caracteres atual é acolchoado com espaços ou com um caractere Unicode especificado.

Sobrecargas

Nome Description
PadRight(Int32)

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

Retorna uma nova cadeia de caracteres que alinha os caracteres nessa cadeia de caracteres preenchendo-os à direita com um caractere Unicode especificado, para um comprimento total especificado.

PadRight(Int32)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Retorna uma nova cadeia de caracteres que alinha os caracteres nessa cadeia de caracteres 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 de caracteres resultante, igual ao número de caracteres originais mais quaisquer caracteres de preenchimento adicionais.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à esquerda e acolchoada à direita com quantos espaços forem necessários para criar um comprimento de totalWidth. No entanto, se totalWidth for menor que o comprimento dessa instância, o método retornará uma referência à instância existente. Se totalWidth for igual ao comprimento dessa instância, o método retornará 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 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|".

Comentários

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

O PadRight(Int32) método acompanha o final da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele armazena a parte esquerda da cadeia de caracteres.

Note

Se o PadRight método contém 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, retorna uma nova cadeia de caracteres que é acolchoada com espaço em branco à direita para que seu comprimento total seja totalWidth de caracteres.

Confira também

Aplica-se a

PadRight(Int32, Char)

Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs
Origem:
String.Manipulation.cs

Retorna uma nova cadeia de caracteres que alinha os caracteres nessa cadeia de caracteres preenchendo-os à direita com um caractere 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 de caracteres resultante, igual ao número de caracteres originais mais quaisquer caracteres de preenchimento adicionais.

paddingChar
Char

Um caractere de preenchimento Unicode.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à esquerda e acolchoada à direita com quantos caracteres paddingChar forem necessários para criar um comprimento de totalWidth. No entanto, se totalWidth for menor que o comprimento dessa instância, o método retornará uma referência à instância existente. Se totalWidth for igual ao comprimento dessa instância, o método retornará 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 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|".

Comentários

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

Note

Se o PadRight método contém 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 é acolchoada com caracteres à paddingChar direita para que seu comprimento total seja totalWidth de caracteres.

Confira também

Aplica-se a