String.PadRight Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

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

Przeciążenia

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

PadRight(Int32)

Źródło:

String.Manipulation.cs

Zwraca nowy ciąg, który wyrównuje znaki w tym ciągu, dopeł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 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 lewej i wypełniony po prawej 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ę PadRight .

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

let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // 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 definiowana jako 0x0020 szesnastkowa.

Metoda PadRight(Int32) podpełnia koniec zwróconego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej do lewej część ciągu jest dopełniana lewą częścią ciągu.

Note

PadRight 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 końcowym białym znakiem, tak aby jego łączna długość to totalWidth znaki.

Zobacz też

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

PadRight(Int32, Char)

Źródło:

String.Manipulation.cs

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

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 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 lewej i dopełniony po prawej 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ę PadRight .

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

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

let str = "forty-two"
let pad = '.'

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{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) podpełnia koniec zwróconego ciągu. Oznacza to, że w przypadku użycia z językami od prawej do lewej do lewej część ciągu jest dopełniana lewą częścią ciągu.

Note

PadRight 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 końcowymi paddingChar , tak aby jego łączna długość to totalWidth znaki.

Zobacz też

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