String.PadRight Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 .