String.PadRight Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma nova cadeia de caracteres de um comprimento especificado no qual o fim da cadeia de caracteres atual é preenchido com espaços ou com um caractere Unicode especificado.
Sobrecargas
| PadRight(Int32) |
Retorna uma nova cadeia de caracteres que alinha os caracteres à esquerda nessa cadeia de caracteres, preenchendo-os com espaços à direita, para um tamanho total especificado. |
| PadRight(Int32, Char) |
Retorna uma nova cadeia de caracteres que alinha os caracteres à esquerda nessa cadeia de caracteres, preenchendo-os à direita com um caractere Unicode especificado, para um tamanho total especificado. |
PadRight(Int32)
Retorna uma nova cadeia de caracteres que alinha os caracteres à esquerda nessa cadeia de caracteres, preenchendo-os com espaços à direita, para um tamanho total especificado.
public:
System::String ^ PadRight(int totalWidth);public string PadRight (int totalWidth);member this.PadRight : int -> stringPublic Function PadRight (totalWidth As Integer) As StringParâmetros
- totalWidth
- Int32
O número de caracteres na cadeia de caracteres resultante, igual ao número de caracteres originais mais alguns caracteres de preenchimento adicionais.
Retornos
Uma nova cadeia de caracteres equivalente a essa instância, mas alinhada à esquerda e preenchida à direita com quantos caracteres forem necessários para criar um tamanho de 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.
Exceções
totalWidth é menor que zero.
Exemplos
O exemplo a seguir demonstra o PadRight método.
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|".
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|".
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 preenche o final da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele preenche a parte esquerda da cadeia de caracteres.
Observação
Se o PadRight método preencha a instância atual com caracteres de espaço em branco, esse método não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres que é preenchida com espaços em branco à direita para que seu comprimento total seja de totalWidth caracteres.
Confira também
Aplica-se a
PadRight(Int32, Char)
Retorna uma nova cadeia de caracteres que alinha os caracteres à esquerda nessa cadeia de caracteres, preenchendo-os à direita com um caractere Unicode especificado, para um tamanho total especificado.
public:
System::String ^ PadRight(int totalWidth, char paddingChar);public string PadRight (int totalWidth, char paddingChar);member this.PadRight : int * char -> stringPublic Function PadRight (totalWidth As Integer, paddingChar As Char) As StringParâmetros
- totalWidth
- 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
- Char
Um caractere de preenchimento de Unicode.
Retornos
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.
Exceções
totalWidth é menor que zero.
Exemplos
O exemplo a seguir demonstra o PadRight método.
String^ str = "forty-two";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".
string str = "forty-two";
char pad = '.';
Console.WriteLine(str.PadRight(15, pad)); // Displays "forty-two......".
Console.WriteLine(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 pads do final da cadeia de caracteres retornada. Isso significa que, quando usado com idiomas da direita para a esquerda, ele padreira a parte esquerda da cadeia de caracteres.
Observação
Se o método for pad com a instância atual com caracteres de espaço em branco, esse método PadRight não modificará o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres que é preenchimento com caracteres à sua parte, paddingChar de modo que seu comprimento total seja totalWidth caracteres.