Udostępnij za pośrednictwem

String.PadRight 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 koniec bieżącego ciągu jest dopłacany spacjami lub określonym znakiem Unicode.

Przeciążenia

PadRight(Int32)

Zwraca nowy ciąg, który do lewej strony wyrównuje znaki w tym ciągu, wypełniając je spacjami po prawej stronie dla określonej całkowitej długości.
PadRight(Int32, Char)

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

PadRight(Int32)

Zwraca nowy ciąg, który do lewej strony wyrównuje znaki w tym ciągu, wypełniając je spacjami po prawej stronie dla określonej całkowitej długości.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight (int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (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 lewej i dosłoowany po prawej 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 PadRight metodę .

String^ str = "BBQ and Slaw";
Console::Write( "|" );
Console::Write( str->PadRight( 15 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw   |".
Console::Write( "|" );
Console::Write( str->PadRight( 5 ) );
Console::WriteLine( "|" ); // Displays "|BBQ and Slaw|".

string str;
str = "BBQ and Slaw";

Console.Write("|");
Console.Write(str.PadRight(15));
Console.WriteLine("|");       // Displays "|BBQ and Slaw   |".

Console.Write("|");
Console.Write(str.PadRight(5));
Console.WriteLine("|");       // Displays "|BBQ and Slaw|".

Dim str As String
str = "BBQ and Slaw"

Console.Write("|")
Console.Write(str.PadRight(15))
Console.WriteLine("|") ' Displays "|BBQ and Slaw   |".

Console.Write("|")
Console.Write(str.PadRight(5))
Console.WriteLine("|") ' Displays "|BBQ and Slaw|".

Uwagi

Spacja Unicode jest zdefiniowana jako 0x0020.

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

Uwaga

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

Zobacz też

Dotyczy

PadRight(Int32, Char)

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

public:
 System::String ^ PadRight(int totalWidth, char paddingChar);
public string PadRight (int totalWidth, char paddingChar);
member this.PadRight : int * char -> string
Public Function PadRight (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 lewej i wsadowany po prawej stronie przy użyciu tylu znaków, ile jest potrzebnych do paddingChar utworzenia długości totalWidth . Jeśli jednak wartość jest mniejsza niż totalWidth długość tego wystąpienia, metoda zwraca odwołanie do istniejącego wystąpienia. Jeśli wartość jest równa długości tego wystąpienia, metoda zwraca nowy ciąg, który totalWidth 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 PadRight metodę .

String^ str = "forty-two";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".

string str = "forty-two";
char pad = '.';

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

Uwagi

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

Uwaga

Jeśli metoda dopasowywuje bieżące wystąpienie znakami odstępu, ta metoda nie modyfikuje PadRight wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, który jest dopasowyowany do znaków na końcowej stronie, tak aby jego całkowita paddingChar długość była totalWidth znakami.

Zobacz też

Dotyczy