String.PadRight Methode

Definition

Gibt eine neue Zeichenfolge einer angegebenen Länge zurück, in der das Ende der aktuellen Zeichenfolge mit Leerzeichen oder einem angegebenen Unicode-Zeichen aufgefüllt wird.

Überlädt

Name Beschreibung
PadRight(Int32)

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Zeichenfolge linksbündig ausgerichtet, indem sie mit Leerzeichen rechts für eine angegebene Gesamtlänge aufgefüllt werden.

PadRight(Int32, Char)

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Zeichenfolge linksbündig ausgerichtet, indem sie auf der rechten Seite mit einem angegebenen Unicode-Zeichen für eine angegebene Gesamtlänge aufgefüllt werden.

PadRight(Int32)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Zeichenfolge linksbündig ausgerichtet, indem sie mit Leerzeichen rechts für eine angegebene Gesamtlänge aufgefüllt werden.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight(int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (totalWidth As Integer) As String

Parameter

totalWidth
Int32

Die Anzahl der Zeichen in der resultierenden Zeichenfolge entspricht der Anzahl der ursprünglichen Zeichen sowie aller zusätzlichen Abstandszeichen.

Gibt zurück

Eine neue Zeichenfolge, die dieser Instanz entspricht, linksbündig und auf der rechten Seite mit so vielen Leerzeichen wie erforderlich, um eine Länge von totalWidthzu erstellen. Wenn totalWidth die Länge dieser Instanz jedoch kleiner ist, gibt die Methode einen Verweis auf die vorhandene Instanz zurück. Wenn totalWidth die Länge dieser Instanz gleich ist, gibt die Methode eine neue Zeichenfolge zurück, die mit dieser Instanz identisch ist.

Ausnahmen

totalWidth ist kleiner als 0 (null).

Beispiele

Im folgenden Beispiel wird die PadRight Methode veranschaulicht.

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

Hinweise

Ein Unicode-Leerzeichen wird als hexadezimales 0x0020 definiert.

Die PadRight(Int32) Methodenpads am Ende der zurückgegebenen Zeichenfolge. Dies bedeutet, dass sie bei Verwendung mit Rechts-nach-links-Sprachen den linken Teil der Zeichenfolge auffüllt.

Note

Wenn die Methode die PadRight aktuelle Instanz mit Leerzeichen auffüllt, ändert diese Methode nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, die mit nachfolgendem Leerzeichen aufgefüllt wird, sodass die Gesamtlänge Zeichen ist totalWidth .

Weitere Informationen

Gilt für:

PadRight(Int32, Char)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Zeichenfolge linksbündig ausgerichtet, indem sie auf der rechten Seite mit einem angegebenen Unicode-Zeichen für eine angegebene Gesamtlänge aufgefüllt werden.

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

Parameter

totalWidth
Int32

Die Anzahl der Zeichen in der resultierenden Zeichenfolge entspricht der Anzahl der ursprünglichen Zeichen sowie aller zusätzlichen Abstandszeichen.

paddingChar
Char

Ein Unicode-Abstandszeichen.

Gibt zurück

Eine neue Zeichenfolge, die dieser Instanz entspricht, linksbündig und auf der rechten Seite mit so vielen paddingChar Zeichen wie erforderlich, um eine Länge von totalWidth. Wenn totalWidth die Länge dieser Instanz jedoch kleiner ist, gibt die Methode einen Verweis auf die vorhandene Instanz zurück. Wenn totalWidth die Länge dieser Instanz gleich ist, gibt die Methode eine neue Zeichenfolge zurück, die mit dieser Instanz identisch ist.

Ausnahmen

totalWidth ist kleiner als 0 (null).

Beispiele

Im folgenden Beispiel wird die PadRight Methode veranschaulicht.

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

Hinweise

Die PadRight(Int32, Char) Methodenpads am Ende der zurückgegebenen Zeichenfolge. Dies bedeutet, dass sie bei Verwendung mit Rechts-nach-links-Sprachen den linken Teil der Zeichenfolge auffüllt.

Note

Wenn die Methode die PadRight aktuelle Instanz mit Leerzeichen auffüllt, ändert diese Methode nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, die mit nachgestellten paddingChar Zeichen aufgefüllt wird, sodass die Gesamtlänge Zeichen ist totalWidth .

Weitere Informationen

Gilt für: