String.PadLeft Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

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

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 całkowitej długości.
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)

Ź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 całkowitej długości.

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 ciągu wynikowym, równa liczbie oryginalnych znaków i znaków dodatkowych dopełnienia.

paddingChar

Char

Znak dopeł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 jednak totalWidth jest mniejsza niż długość tego wystąpienia, 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 pokazano metodę PadLeft .

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two

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) dopełnia początek zwracanego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej dopełnia prawą część ciągu.

Uwaga

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

Zobacz też

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

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 ciągu wynikowym, równa liczbie oryginalnych znaków i znaków dodatkowych dopełnienia.

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ą spacji, aby utworzyć długość totalWidth. Jeśli jednak totalWidth jest mniejsza niż długość tego wystąpienia, 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 pokazano 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".

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

Przestrzeń Unicode jest definiowana jako 0x0020 szesnastkowa.

Metoda PadLeft(Int32) dopełnia początek zwracanego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej dopełnia prawą część ciągu.

Uwaga

PadLeft Jeśli metoda dopełnia bieżące wystąpienie znakami 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 odstępem, tak aby jego łączna długość to totalWidth znaki.

Zobacz też

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