String.PadLeft Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

PadLeft(Int32)

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

String.Manipulation.cs

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

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

public string PadLeft(int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (totalWidth As Integer) As String

Параметры

totalWidth

Int32

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

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

String

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

Исключения

ArgumentOutOfRangeException

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

Примеры

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

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{str.PadLeft 5}"   // Displays "BBQ and Slaw".

Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Комментарии

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

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

Note

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

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

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

PadLeft(Int32, Char)

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

String.Manipulation.cs

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

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);

public string PadLeft(int totalWidth, char paddingChar);

member this.PadLeft : int * char -> string

Public Function PadLeft (totalWidth As Integer, paddingChar As Char) As String

Параметры

totalWidth

Int32

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

paddingChar

Char

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

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

String

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

Исключения

ArgumentOutOfRangeException

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

Примеры

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

using System;

class Sample
{
   public static void Main()
   {
   string str = "forty-two";
   char pad = '.';

   Console.WriteLine(str.PadLeft(15, pad));
   Console.WriteLine(str.PadLeft(2, pad));
   }
}
// The example displays the following output:
//       ......forty-two
//       forty-two

let str = "forty-two"
let pad = '.'

printfn $"{str.PadLeft(15, pad)}"
printfn $"{str.PadLeft(2, pad)}"
// The example displays the following output:
//       ......forty-two
//       forty-two

Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Комментарии

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

Note

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

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

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