String.PadLeft Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Egy megadott hosszúságú új sztringet ad vissza, amelyben az aktuális sztring elejét szóközökkel vagy egy megadott Unicode-karakterrel van elválasztva.

Túlterhelések

Name	Description
PadLeft(Int32)	Egy új sztringet ad vissza, amely jobbra igazítja az ebben a példányban lévő karaktereket úgy, hogy a bal oldalon szóközökkel vannak elválasztva egy megadott teljes hosszra.
PadLeft(Int32, Char)	Egy új sztringet ad vissza, amely jobbra igazítja a jelen példányban lévő karaktereket úgy, hogy a bal oldalon egy megadott Unicode-karaktert használ egy megadott teljes hosszra.

PadLeft(Int32)

Forrás:

String.Manipulation.cs

Egy új sztringet ad vissza, amely jobbra igazítja az ebben a példányban lévő karaktereket úgy, hogy a bal oldalon szóközökkel vannak elválasztva egy megadott teljes hosszra.

public:
 System::String ^ PadLeft(int totalWidth);

public string PadLeft(int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (totalWidth As Integer) As String

Paraméterek

totalWidth

Int32

Az eredményül kapott sztringben szereplő karakterek száma, amely megegyezik az eredeti karakterek számával és a további kitöltési karakterekkel.

Válaszok

String

Egy új sztring, amely egyenértékű ezzel a példánnyal, de a bal oldalon jobbra igazított és kipárnázott, annyi szóközzel, amennyi szükséges a hossz totalWidthlétrehozásához. Ha totalWidth azonban kisebb, mint a példány hossza, a metódus a meglévő példányra mutató hivatkozást ad vissza. Ha totalWidth a példány hossza megegyezik, a metódus egy új sztringet ad vissza, amely megegyezik ezzel a példánysal.

Kivételek

ArgumentOutOfRangeException

totalWidth kisebb, mint nulla.

Példák

Az alábbi példa a metódust PadLeft mutatja be.

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

Megjegyzések

A Unicode-szóköz hexadecimális 0x0020.

A PadLeft(Int32) metódus a visszaadott sztring elejét párnázza. Ez azt jelenti, hogy jobbról balra író nyelvek használata esetén a sztring jobb oldali részét is bepárnázza.

Note

Ha a PadLeft metódus üres szóköz karakterekkel jeleníti meg az aktuális példányt, ez a metódus nem módosítja az aktuális példány értékét. Ehelyett egy új sztringet ad vissza, amelynek kezdő szóközzel van elosztva, így a teljes hossza totalWidth karakter.

Lásd még

• Int32
• PadRight(Int32)
• Trim(Char[])

PadLeft(Int32, Char)

Forrás:

String.Manipulation.cs

Egy új sztringet ad vissza, amely jobbra igazítja a jelen példányban lévő karaktereket úgy, hogy a bal oldalon egy megadott Unicode-karaktert használ egy megadott teljes hosszra.

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

Paraméterek

totalWidth

Int32

Az eredményül kapott sztringben szereplő karakterek száma, amely megegyezik az eredeti karakterek számával és a további kitöltési karakterekkel.

paddingChar

Char

Unicode-kitöltési karakter.

Válaszok

String

Egy új sztring, amely megegyezik ezzel a példánnyal, de a bal oldalon jobbra igazított és ki van illesztve annyi paddingChar karakterrel, amennyi szükséges a hossz totalWidthlétrehozásához. Ha totalWidth azonban kisebb, mint a példány hossza, a metódus a meglévő példányra mutató hivatkozást ad vissza. Ha totalWidth a példány hossza megegyezik, a metódus egy új sztringet ad vissza, amely megegyezik ezzel a példánysal.

Kivételek

ArgumentOutOfRangeException

totalWidth kisebb, mint nulla.

Példák

Az alábbi példa a metódust PadLeft mutatja be.

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

Megjegyzések

A PadLeft(Int32, Char) metódus a visszaadott sztring elejét párnázza. Ez azt jelenti, hogy jobbról balra író nyelvek használata esetén a sztring jobb oldali részét is bepárnázza.

Note

Ha a PadLeft metódus üres szóköz karakterekkel jeleníti meg az aktuális példányt, ez a metódus nem módosítja az aktuális példány értékét. Ehelyett egy új sztringet ad vissza, amely bevezető paddingChar karakterekkel van bepárnázva, így teljes hossza karakterek.totalWidth

Lásd még

• Char
• Int32
• PadRight(Int32)
• Trim(Char[])