(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

String.PadRight-Methode (Int32)

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
Typ: 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

Typ: System.String
Eine neue Zeichenfolge, die dieser Instanz entspricht, jedoch linksbündig ausgerichtet und rechts 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.

AusnahmeBedingung
ArgumentOutOfRangeException

totalWidth ist kleiner als 0 (null).

Ein Unicode-Leerzeichen wird im Hexadezimalformat 0x0020 definiert.

Die PadRight(Int32)-Methode füllt das Ende der zurückgegebenen Zeichenfolge auf. Bei Sprachen mit Leserichtung von rechts nach links bedeutet dies, dass der linke Teil der Zeichenfolge aufgefüllt wird.

HinweisHinweis

Diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen gibt sie eine neue Zeichenfolge zurück, die mit folgenden Leerstellen aufgefüllt wird, damit ihre Gesamtlänge totalWidth Zeichen beträgt.

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


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft