String.PadRight Метод

Определение

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

System

Сборка:

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

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) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Примечание

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

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) заполняет конец возвращаемой строки. Это означает, что при использовании с языками справа налево она заполняет левую часть строки.

Примечание

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

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

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