String.PadRight Metoda

Definice

Obor názvů:
System
Sestavení:
mscorlib.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Vrátí nový řetězec s zadanou délkou, ve které je konec aktuálního řetězce vycpaný mezerami nebo se zadaným znakem Unicode.

Přetížení

Name Description
PadRight(Int32)

Vrátí nový řetězec, který zarovná znaky v tomto řetězci tak, že je odsadí mezerami napravo pro zadanou celkovou délku.
PadRight(Int32, Char)

Vrátí nový řetězec, který zarovná znaky v tomto řetězci tak, že je odsadí na pravé straně se zadaným znakem Unicode pro zadanou celkovou délku.

PadRight(Int32)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, který zarovná znaky v tomto řetězci tak, že je odsadí mezerami napravo pro zadanou celkovou délku.

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

Početznakůch

Návraty

String

Nový řetězec, který je ekvivalentní této instanci, ale vlevo zarovnaný a zarovnaný vpravo s tolika mezerami, kolik je potřeba k vytvoření délky totalWidth. Pokud totalWidth je však menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth je rovna délce této instance, metoda vrátí nový řetězec, který je identický s touto instancí.

Výjimky

ArgumentOutOfRangeException

Hodnota totalWidth je menší než nula.

Příklady

Následující příklad ukazuje metodu 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|".

Poznámky

Mezera v kódování Unicode je definována jako šestnáctková 0x0020.

Metoda PadRight(Int32) vycpá konec vráceného řetězce. To znamená, že když se používá s jazyky se zápisem zprava doleva, vloží levou část řetězce.

Note

PadRight Pokud metoda pad aktuální instance s prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vycpaný koncovým prázdným znakem, aby jeho celková délka byla totalWidth znaky.

Viz také

Platí pro

PadRight(Int32, Char)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, který zarovná znaky v tomto řetězci tak, že je odsadí na pravé straně se zadaným znakem Unicode pro zadanou celkovou délku.

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

Početznakůch

paddingChar
Char

Znak odsazení unicode.

Návraty

String

Nový řetězec, který je ekvivalentní této instanci, ale vlevo zarovnaný a vycpaný vpravo s tolika paddingChar znaky, kolik je potřeba k vytvoření délky totalWidth. Pokud totalWidth je však menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth je rovna délce této instance, metoda vrátí nový řetězec, který je identický s touto instancí.

Výjimky

ArgumentOutOfRangeException

Hodnota totalWidth je menší než nula.

Příklady

Následující příklad ukazuje metodu 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|".

Poznámky

Metoda PadRight(Int32, Char) vycpá konec vráceného řetězce. To znamená, že když se používá s jazyky se zápisem zprava doleva, vloží levou část řetězce.

Note

PadRight Pokud metoda pad aktuální instance s prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vycpaný koncovými paddingChar znaky, aby jeho celková délka byla totalWidth znaky.

Viz také

Platí pro