String.PadLeft Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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
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
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
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.