String.PadRight 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 vége szóközökkel vagy egy megadott Unicode-karakterrel van elválasztva.

Túlterhelések

Name	Description
PadRight(Int32)	Egy új sztringet ad vissza, amely balról igazítja a sztringben lévő karaktereket úgy, hogy a jobb oldalon szóközökkel vannak elválasztva egy megadott teljes hosszra.
PadRight(Int32, Char)	Egy új sztringet ad vissza, amely balra igazítja a sztringben szereplő karaktereket úgy, hogy a jobb oldalon egy megadott Unicode-karaktert használ egy megadott teljes hosszra.

PadRight(Int32)

Forrás:

String.Manipulation.cs

Egy új sztringet ad vissza, amely balról igazítja a sztringben lévő karaktereket úgy, hogy a jobb oldalon szóközökkel vannak elválasztva egy megadott teljes hosszra.

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

public string PadRight(int totalWidth);

member this.PadRight : int -> string

Public Function PadRight (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 megegyezik ezzel a példánnyal, de balra igazított, és a jobb oldalon annyi szóközzel van elválasztva, 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 PadRight mutatja be.

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

let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // Displays "|BBQ and Slaw|".

Dim str As String
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|".

Megjegyzések

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

A PadRight(Int32) metódus a visszaadott sztring végét párnázza ki. Ez azt jelenti, hogy jobbról balra író nyelvek használata esetén a sztring bal oldali részét jelöli.

Note

Ha a PadRight 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, amelyet záró üres területtel van eltömítve, hogy a teljes hossza karakter legyen totalWidth .

Lásd még

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

PadRight(Int32, Char)

Forrás:

String.Manipulation.cs

Egy új sztringet ad vissza, amely balra igazítja a sztringben szereplő karaktereket úgy, hogy a jobb oldalon egy megadott Unicode-karaktert használ egy megadott teljes hosszra.

public:
 System::String ^ PadRight(int totalWidth, char paddingChar);

public string PadRight(int totalWidth, char paddingChar);

member this.PadRight : int * char -> string

Public Function PadRight (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 egyenértékű ezzel a példánnyal, de balra igazított, és a jobb oldalon annyi karakterrel van elválasztva, paddingChar 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 PadRight mutatja be.

string str = "forty-two";
char pad = '.';

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

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

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{str.PadRight(2, pad)}"    // Displays "forty-two".

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

Megjegyzések

A PadRight(Int32, Char) metódus a visszaadott sztring végét párnázza ki. Ez azt jelenti, hogy jobbról balra író nyelvek használata esetén a sztring bal oldali részét jelöli.

Note

Ha a PadRight 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 záró paddingChar karakterekkel van elválasztva, így a teljes hossza karakterek.totalWidth

Lásd még

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