String.PadRight Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Возвращает новую строку указанной длины, в которой конец текущей строки заполняется пробелами или заданным символом Юникода.

Перегрузки

Имя	Описание
PadRight(Int32)	Возвращает новую строку, выравнивающую символы в этой строке, забив их пробелами справа для указанной общей длины.
PadRight(Int32, Char)	Возвращает новую строку, выравнивающую символы в этой строке, заставив их справа с указанным символом Юникода для указанной общей длины.

PadRight(Int32)

Исходный код:

String.Manipulation.cs

Возвращает новую строку, выравнивающую символы в этой строке, забив их пробелами справа для указанной общей длины.

public:
 System::String ^ PadRight(int totalWidth);

public string PadRight(int totalWidth);

member this.PadRight : int -> string

Public Function PadRight (totalWidth As Integer) As String

Параметры

totalWidth

Int32

Число символов в результирующей строке, равное числу исходных символов, а также любым дополнительным символам заполнения.

Возвращаемое значение

String

Новая строка, эквивалентная этому экземпляру, но выровненная по левому краю и заполненная справа с большим количеством пробелов, необходимых для создания длины totalWidth. Однако если totalWidth длина этого экземпляра меньше длины, метод возвращает ссылку на существующий экземпляр. Если totalWidth длина этого экземпляра равна длине, метод возвращает новую строку, идентичную этому экземпляру.

Исключения

ArgumentOutOfRangeException

totalWidth меньше нуля.

Примеры

В следующем примере демонстрируется PadRight метод.

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|".

Комментарии

Пространство Юникода определяется как шестнадцатеричное 0x0020.

Метод PadRight(Int32) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Note

PadRight Если метод заполняет текущий экземпляр символами пробелов, этот метод не изменяет значение текущего экземпляра. Вместо этого он возвращает новую строку, которая заполняется конечным пробелом, чтобы ее общая длина была totalWidth символами.

См. также раздел

• Int32
• PadLeft(Int32)
• Trim(Char[])

PadRight(Int32, Char)

Исходный код:

String.Manipulation.cs

Возвращает новую строку, выравнивающую символы в этой строке, заставив их справа с указанным символом Юникода для указанной общей длины.

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

Параметры

totalWidth

Int32

Число символов в результирующей строке, равное числу исходных символов, а также любым дополнительным символам заполнения.

paddingChar

Char

Символ заполнения Юникода.

Возвращаемое значение

String

Новая строка, эквивалентная этому экземпляру, но выровненная по левому краю и заполненная справа с большим количеством paddingChar символов, необходимых для создания длины totalWidth. Однако если totalWidth длина этого экземпляра меньше длины, метод возвращает ссылку на существующий экземпляр. Если totalWidth длина этого экземпляра равна длине, метод возвращает новую строку, идентичную этому экземпляру.

Исключения

ArgumentOutOfRangeException

totalWidth меньше нуля.

Примеры

В следующем примере демонстрируется 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".

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|".

Комментарии

Метод PadRight(Int32, Char) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Note

PadRight Если метод заполняет текущий экземпляр символами пробелов, этот метод не изменяет значение текущего экземпляра. Вместо этого он возвращает новую строку, которая заполняется конечными paddingChar символами, чтобы ее общая длина была totalWidth символами.

См. также раздел

• Char
• Int32
• PadLeft(Int32)
• Trim(Char[])