Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

String.PadRight-Methode: (Int32)

 

Veröffentlicht: Oktober 2016

Gibt eine neue Zeichenfolge zurück, deren Zeichen linksbündig ausgerichtet werden, indem die rechte Seite mit Leerzeichen aufgefüllt wird, um eine angegebene Gesamtlänge zu erreichen.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public string PadRight(
	int totalWidth
)

Parameter

totalWidth
Type: System.Int32

Die Anzahl der Zeichen in der resultierenden Zeichenfolge, entsprechend der Anzahl der ursprünglichen Zeichen zuzüglich aller zusätzlichen Füllzeichen.

Rückgabewert

Type: System.String

Eine neue Zeichenfolge, die dieser Instanz entspricht, jedoch rechtsbündig ausgerichtet und links mit Leerzeichen aufgefüllt ist, sodass die Länge totalWidth erreicht wird. Wenn totalWidth jedoch kleiner als die Länge dieser Instanz ist, gibt die Methode einen Verweis auf die vorhandene Instanz zurück. Wenn totalWidth gleich der Länge dieser Instanz ist, gibt die Methode eine neue Zeichenfolge zurück, die mit dieser Instanz identisch ist.

Exception Condition
ArgumentOutOfRangeException

totalWidth ist kleiner als Null.

Ein Unicode-Leerzeichen ist definiert als hexadezimale 0 x 0020.

Die PadRight(Int32) -Methode füllt das Ende der zurückgegebenen Zeichenfolge. Dies bedeutet, dass bei Verwendung mit rechts-nach-links-Sprachen den linken Teil der Zeichenfolge aufgefüllt.

System_CAPS_noteHinweis

Wenn diePadRight Methode füllt die aktuelle Instanz mit Leerzeichen, diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen gibt es eine neue Zeichenfolge, die mit nachfolgenden Leerzeichen aufgefüllt wird, damit die Gesamtlänge zu erreichen ist totalWidth Zeichen.

Das folgende Beispiel veranschaulicht die PadRight Methode.

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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: