String.PadRight Метод

Определение

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

Перегрузки

PadRight(Int32)

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

PadRight(Int32, Char)

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

PadRight(Int32)

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

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

public string PadRight (int totalWidth);

Параметры

totalWidth
Int32

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

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

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

Исключения

Значение параметра 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|".

Комментарии

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

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

Ескерім

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

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

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

PadRight(Int32, Char)

Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs
Исходный код:
String.Manipulation.cs

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

public string PadRight (int totalWidth, char paddingChar);

Параметры

totalWidth
Int32

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

paddingChar
Char

Добавляемый в качестве заполнителя знак Юникода.

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

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

Исключения

Значение параметра 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".

Комментарии

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

Ескерім

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

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

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0