String.PadLeft Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Runtime.dll
Zestaw:
netstandard.dll
Zestaw:
mscorlib.dll

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

Przeciążenia

PadLeft(Int32)

Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu do prawej strony, wypeł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 do prawej strony, wypeł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 do prawej strony, wypeł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 dosłonyny po lewej stronie przy użyciu tylu spacji, ile jest potrzebnych do utworzenia długości totalWidth . Jeśli jednak totalWidth wartość jest mniejsza niż długość tego wystąpienia, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth wartość 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 PadLeft metodę .

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

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 zdefiniowana jako 0x0020.

Metoda PadLeft(Int32) dopasowywuje początek zwracanych ciągów. Oznacza to, że w przypadku korzystania z języków od prawej do lewej dolewa prawą część ciągu.

Uwaga

Jeśli metoda dokańczy bieżące wystąpienie znakami odstępu, ta metoda nie modyfikuje PadLeft wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest dopłacany wiodącym białym znakiem, tak aby jego całkowita długość była totalWidth znakami.

Zobacz też

Dotyczy

PadLeft(Int32, Char)

Zwraca nowy ciąg, który wyrównuje znaki w tym wystąpieniu do prawej strony, wypeł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 dosłonyny po lewej stronie przy użyciu tylu znaków, ile jest potrzebnych do utworzenia paddingChar długości totalWidth . Jeśli jednak totalWidth wartość jest mniejsza niż długość tego wystąpienia, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli totalWidth wartość 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 PadLeft metodę .

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

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) dopasowywuje początek zwracanych ciągów. Oznacza to, że w przypadku korzystania z języków od prawej do lewej dolewa prawą część ciągu.

Uwaga

Jeśli metoda dokańczy bieżące wystąpienie znakami odstępu, ta metoda nie modyfikuje PadLeft wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest dopłacany znakami wiodącymi, tak aby paddingChar jego całkowita długość była totalWidth znakami.

Zobacz też

Dotyczy