String.PadLeft Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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

Überlädt

Name Beschreibung
PadLeft(Int32)

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Instanz rechtsbündig ausrichtet, indem sie für eine angegebene Gesamtlänge mit Leerzeichen links aufgefüllt werden.
PadLeft(Int32, Char)

Gibt eine neue Zeichenfolge zurück, die die Zeichen in dieser Instanz rechtsbündig ausgerichtet, indem sie links mit einem angegebenen Unicode-Zeichen für eine angegebene Gesamtlänge aufgefüllt werden.

PadLeft(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 Instanz rechtsbündig ausrichtet, indem sie für eine angegebene Gesamtlänge mit Leerzeichen links aufgefüllt werden.

public:
 System::String ^ PadLeft(int totalWidth);
public string PadLeft(int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (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

String

Eine neue Zeichenfolge, die dieser Instanz entspricht, rechtsbündig und links 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

ArgumentOutOfRangeException

totalWidth ist kleiner als 0 (null).

Beispiele

Im folgenden Beispiel wird die PadLeft Methode veranschaulicht.

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{str.PadLeft 5}"   // Displays "BBQ and Slaw".

Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Hinweise

Ein Unicode-Leerzeichen wird als hexadezimales 0x0020 definiert.

Die PadLeft(Int32) Methodenpads am Anfang der zurückgegebenen Zeichenfolge. Dies bedeutet, dass er bei Verwendung mit Rechts-nach-links-Sprachen den rechten Teil der Zeichenfolge auffüllt.

Note

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

Weitere Informationen

Gilt für:

PadLeft(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 Instanz rechtsbündig ausgerichtet, indem sie links mit einem angegebenen Unicode-Zeichen für eine angegebene Gesamtlänge aufgefüllt werden.

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);
public string PadLeft(int totalWidth, char paddingChar);
member this.PadLeft : int * char -> string
Public Function PadLeft (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

String

Eine neue Zeichenfolge, die dieser Instanz entspricht, aber rechtsbündig und links 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

ArgumentOutOfRangeException

totalWidth ist kleiner als 0 (null).

Beispiele

Im folgenden Beispiel wird die PadLeft Methode veranschaulicht.

using System;

class Sample
{
   public static void Main()
   {
   string str = "forty-two";
   char pad = '.';

   Console.WriteLine(str.PadLeft(15, pad));
   Console.WriteLine(str.PadLeft(2, pad));
   }
}
// The example displays the following output:
//       ......forty-two
//       forty-two

let str = "forty-two"
let pad = '.'

printfn $"{str.PadLeft(15, pad)}"
printfn $"{str.PadLeft(2, pad)}"
// The example displays the following output:
//       ......forty-two
//       forty-two

Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Hinweise

Die PadLeft(Int32, Char) Methodenpads am Anfang der zurückgegebenen Zeichenfolge. Dies bedeutet, dass er bei Verwendung mit Rechts-nach-links-Sprachen den rechten Teil der Zeichenfolge auffüllt.

Note

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

Weitere Informationen

Gilt für: