String.PadRight Metode

Definisi

Ruang nama:
System
Rakitan:
mscorlib.dll, System.Runtime.dll
Rakitan:
netstandard.dll, System.Runtime.dll
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll

Mengembalikan string baru dengan panjang yang ditentukan di mana akhir string saat ini diisi dengan spasi atau dengan karakter Unicode tertentu.

Overload

Nama Deskripsi
PadRight(Int32)

Mengembalikan string baru yang meratakan kiri karakter dalam string ini dengan mengayuhnya dengan spasi di sebelah kanan, untuk panjang total yang ditentukan.
PadRight(Int32, Char)

Mengembalikan string baru yang meratakan kiri karakter dalam string ini dengan mengayuhnya di sebelah kanan dengan karakter Unicode tertentu, untuk panjang total yang ditentukan.

PadRight(Int32)

Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs

Mengembalikan string baru yang meratakan kiri karakter dalam string ini dengan mengayuhnya dengan spasi di sebelah kanan, untuk panjang total yang ditentukan.

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

Parameter

totalWidth
Int32

Jumlah karakter dalam string yang dihasilkan, sama dengan jumlah karakter asli ditambah karakter padding tambahan.

Mengembalikan

String

String baru yang setara dengan instans ini, tetapi rata kiri dan diisi di sebelah kanan dengan ruang sebanyak yang diperlukan untuk membuat panjang totalWidth. Namun, jika totalWidth kurang dari panjang instans ini, metode mengembalikan referensi ke instans yang ada. Jika totalWidth sama dengan panjang instans ini, metode mengembalikan string baru yang identik dengan instans ini.

Pengecualian

ArgumentOutOfRangeException

totalWidth kurang dari nol.

Contoh

Contoh berikut menunjukkan PadRight metode .

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

Keterangan

Ruang Unicode didefinisikan sebagai 0x0020 heksadesimal.

Metode mengalihkan PadRight(Int32) akhir string yang dikembalikan. Ini berarti bahwa, ketika digunakan dengan bahasa kanan-ke-kiri, ia mengalihkan bagian kiri string.

Note

Jika metode mengalihkan PadRight instans saat ini dengan karakter spasi putih, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru yang diisi dengan spasi putih berikutnya sehingga panjang totalnya adalah totalWidth karakter.

Lihat juga

Berlaku untuk

PadRight(Int32, Char)

Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs
Sumber:
String.Manipulation.cs

Mengembalikan string baru yang meratakan kiri karakter dalam string ini dengan mengayuhnya di sebelah kanan dengan karakter Unicode tertentu, untuk panjang total yang ditentukan.

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

Parameter

totalWidth
Int32

Jumlah karakter dalam string yang dihasilkan, sama dengan jumlah karakter asli ditambah karakter padding tambahan.

paddingChar
Char

Karakter padding Unicode.

Mengembalikan

String

String baru yang setara dengan instans ini, tetapi selaras kiri dan diisi di sebelah kanan dengan karakter sebanyak paddingChar yang diperlukan untuk membuat panjang totalWidth. Namun, jika totalWidth kurang dari panjang instans ini, metode mengembalikan referensi ke instans yang ada. Jika totalWidth sama dengan panjang instans ini, metode mengembalikan string baru yang identik dengan instans ini.

Pengecualian

ArgumentOutOfRangeException

totalWidth kurang dari nol.

Contoh

Contoh berikut menunjukkan PadRight metode .

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

Keterangan

Metode mengalihkan PadRight(Int32, Char) akhir string yang dikembalikan. Ini berarti bahwa, ketika digunakan dengan bahasa kanan-ke-kiri, ia mengalihkan bagian kiri string.

Note

Jika metode mengalihkan PadRight instans saat ini dengan karakter spasi putih, metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru yang diisi dengan karakter berikutnya paddingChar sehingga panjang totalnya adalah totalWidth karakter.

Lihat juga

Berlaku untuk