String.PadLeft Metoda

Definice

Obor názvů:
System
Sestavení:
mscorlib.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Vrátí nový řetězec s zadanou délkou, ve které je začátek aktuálního řetězce vycpaný mezerami nebo se zadaným znakem Unicode.

Přetížení

Name Description
PadLeft(Int32)

Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je odsadí mezerami vlevo pro zadanou celkovou délku.
PadLeft(Int32, Char)

Vrátí nový řetězec, který zarovná znaky zprava v této instanci tak, že je odsadí nalevo se zadaným znakem Unicode pro zadanou celkovou délku.

PadLeft(Int32)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, který zarovná znaky v této instanci doprava tak, že je odsadí mezerami vlevo pro zadanou celkovou délku.

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

Parametry

totalWidth
Int32

Početznakůch

Návraty

String

Nový řetězec, který je ekvivalentní této instanci, ale zarovnaný doprava a vycpaný vlevo s tolika mezerami, kolik je potřeba k vytvoření délky totalWidth. Pokud totalWidth je však menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth je rovna délce této instance, metoda vrátí nový řetězec, který je identický s touto instancí.

Výjimky

ArgumentOutOfRangeException

Hodnota totalWidth je menší než nula.

Příklady

Následující příklad ukazuje metodu PadLeft .

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

Poznámky

Mezera v kódování Unicode je definována jako šestnáctková 0x0020.

Metoda PadLeft(Int32) vrátí začátek vráceného řetězce. To znamená, že pokud se používá s jazyky se zápisem zprava doleva, vloží pravou část řetězce.

Note

PadLeft Pokud metoda pad aktuální instance s prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vycpaný počátečním prázdným znakem, aby jeho celková délka byla totalWidth znaky.

Viz také

Platí pro

PadLeft(Int32, Char)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, který zarovná znaky zprava v této instanci tak, že je odsadí nalevo se zadaným znakem Unicode pro zadanou celkovou délku.

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

Parametry

totalWidth
Int32

Početznakůch

paddingChar
Char

Znak odsazení unicode.

Návraty

String

Nový řetězec, který je ekvivalentní této instanci, ale zarovnaný doprava a vycpaný vlevo s tolika paddingChar znaky, kolik je potřeba k vytvoření délky totalWidth. Pokud totalWidth je však menší než délka této instance, metoda vrátí odkaz na existující instanci. Pokud totalWidth je rovna délce této instance, metoda vrátí nový řetězec, který je identický s touto instancí.

Výjimky

ArgumentOutOfRangeException

Hodnota totalWidth je menší než nula.

Příklady

Následující příklad ukazuje metodu PadLeft .

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

Poznámky

Metoda PadLeft(Int32, Char) vrátí začátek vráceného řetězce. To znamená, že pokud se používá s jazyky se zápisem zprava doleva, vloží pravou část řetězce.

Note

PadLeft Pokud metoda pad aktuální instance s prázdnými znaky, tato metoda nezmění hodnotu aktuální instance. Místo toho vrátí nový řetězec, který je vycpaný počátečními paddingChar znaky tak, aby jeho celková délka byla totalWidth znaky.

Viz také

Platí pro