String.PadLeft Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Zwraca nowy ciąg o określonej długości, w którym początek bieżącego ciągu jest wypełniony spacjami lub określonym znakiem Unicode.

Przeciążenia

Nazwa	Opis
PadLeft(Int32)	Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je spacjami po lewej stronie dla określonej całkowitej długości.
PadLeft(Int32, Char)	Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je po lewej stronie określonym znakiem Unicode dla określonej długości całkowitej.

PadLeft(Int32)

Źródło:

String.Manipulation.cs

Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je spacjami po lewej stronie dla określonej całkowitej długości.

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

public string PadLeft(int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (totalWidth As Integer) As String

Parametry

totalWidth

Int32

Liczba znaków w wynikowym ciągu, równa liczbie oryginalnych znaków oraz dodatkowych znaków dopełnienia.

Zwraca

String

Nowy ciąg, który jest odpowiednikiem tego wystąpienia, ale wyrównany do prawej i wyściełany po lewej stronie z dowolną liczbą spacji, aby utworzyć długość totalWidth. Jeśli totalWidth jednak długość tego wystąpienia jest mniejsza niż długość, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth jest równa długości tego wystąpienia, metoda zwraca nowy ciąg, który jest identyczny z tym wystąpieniem.

Wyjątki

ArgumentOutOfRangeException

Parametr totalWidth ma wartość niższą niż zero.

Przykłady

W poniższym przykładzie przedstawiono metodę 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".

Uwagi

Spacja Unicode jest definiowana jako 0x0020 szesnastkowa.

Metoda PadLeft(Int32) podpełnia początek zwróconego ciągu. Oznacza to, że w przypadku użycia w językach od prawej do lewej do prawej części ciągu.

Note

PadLeft Jeśli metoda podpełnia bieżące wystąpienie znakiem odstępu, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest wypełniony wiodącym białym znakiem, tak aby jego łączna długość to totalWidth znaki.

Zobacz też

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

PadLeft(Int32, Char)

Źródło:

String.Manipulation.cs

Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu, dopełniając je po lewej stronie określonym znakiem Unicode dla określonej długości całkowitej.

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

Parametry

totalWidth

Int32

Liczba znaków w wynikowym ciągu, równa liczbie oryginalnych znaków oraz dodatkowych znaków dopełnienia.

paddingChar

Char

Znak wypełnienia Unicode.

Zwraca

String

Nowy ciąg, który jest odpowiednikiem tego wystąpienia, ale wyrównany do prawej i dopełniony po lewej stronie z dowolną liczbą paddingChar znaków, aby utworzyć długość totalWidth. Jeśli totalWidth jednak długość tego wystąpienia jest mniejsza niż długość, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth jest równa długości tego wystąpienia, metoda zwraca nowy ciąg, który jest identyczny z tym wystąpieniem.

Wyjątki

ArgumentOutOfRangeException

Parametr totalWidth ma wartość niższą niż zero.

Przykłady

W poniższym przykładzie przedstawiono metodę 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

Uwagi

Metoda PadLeft(Int32, Char) podpełnia początek zwróconego ciągu. Oznacza to, że w przypadku użycia w językach od prawej do lewej do prawej części ciągu.

Note

PadLeft Jeśli metoda podpełnia bieżące wystąpienie znakiem odstępu, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest wypełniony znakami wiodącymi paddingChar , tak aby jego łączna długość to totalWidth znaki.

Zobacz też

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