String.PadRight Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Geçerli dizenin sonunun boşluklarla veya belirtilen Unicode karakteriyle doldurularak belirtilen uzunlukta yeni bir dize döndürür.

Aşırı Yüklemeler

Name	Description
PadRight(Int32)	Belirtilen toplam uzunluk için bu dizedeki karakterleri sağda boşluklarla doldurarak sola hizalayan yeni bir dize döndürür.
PadRight(Int32, Char)	Bu dizedeki karakterleri, belirtilen toplam uzunluğu için belirtilen unicode karakterle sağa doldurarak sola hizalayan yeni bir dize döndürür.

PadRight(Int32)

Kaynak:

String.Manipulation.cs

Belirtilen toplam uzunluk için bu dizedeki karakterleri sağda boşluklarla doldurarak sola hizalayan yeni bir dize döndürür.

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

public string PadRight(int totalWidth);

member this.PadRight : int -> string

Public Function PadRight (totalWidth As Integer) As String

Parametreler

totalWidth

Int32

Sonuçta elde edilen dizedeki karakterlerin sayısı, özgün karakter sayısına ve ek doldurma karakterlerine eşittir.

Döndürülenler

String

Bu örneğe eşdeğer, ancak uzunluğu oluşturmak için gereken sayıda boşlukla sola hizalanmış ve sağda doldurulmuş yeni bir totalWidthdize. Ancak, bu örneğin uzunluğundan küçükse totalWidth , yöntem mevcut örneğe bir başvuru döndürür. Bu örneğin uzunluğuna eşitse totalWidth , yöntemi bu örnekle aynı olan yeni bir dize döndürür.

Özel durumlar

ArgumentOutOfRangeException

totalWidth, sıfırdan küçüktür.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir PadRight .

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

Açıklamalar

Unicode alanı onaltılık 0x0020 olarak tanımlanır.

yöntemi, PadRight(Int32) döndürülen dizenin sonunu ekler. Bu, sağdan sola dillerle kullanıldığında dizenin sol kısmını doldurması anlamına gelir.

Note

PadRight Yöntem geçerli örneği boşluk karakterleriyle eklerse, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğunun totalWidth karakter olması için sondaki boşlukla doldurulmuş yeni bir dize döndürür.

Ayrıca bkz.

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

PadRight(Int32, Char)

Kaynak:

String.Manipulation.cs

Bu dizedeki karakterleri, belirtilen toplam uzunluğu için belirtilen unicode karakterle sağa doldurarak sola hizalayan yeni bir dize döndürür.

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

Parametreler

totalWidth

Int32

Sonuçta elde edilen dizedeki karakterlerin sayısı, özgün karakter sayısına ve ek doldurma karakterlerine eşittir.

paddingChar

Char

Unicode doldurma karakteri.

Döndürülenler

String

Bu örneğe eşdeğer, ancak uzunluğu oluşturmak için gereken sayıda paddingChar karakterle sola hizalanmış ve sağda doldurulmuş yeni bir totalWidthdize. Ancak, bu örneğin uzunluğundan küçükse totalWidth , yöntem mevcut örneğe bir başvuru döndürür. Bu örneğin uzunluğuna eşitse totalWidth , yöntemi bu örnekle aynı olan yeni bir dize döndürür.

Özel durumlar

ArgumentOutOfRangeException

totalWidth, sıfırdan küçüktür.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir PadRight .

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

Açıklamalar

yöntemi, PadRight(Int32, Char) döndürülen dizenin sonunu ekler. Bu, sağdan sola dillerle kullanıldığında dizenin sol kısmını doldurması anlamına gelir.

Note

PadRight Yöntem geçerli örneği boşluk karakterleriyle eklerse, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğu paddingChar karakter olacak şekilde sondaki totalWidth karakterlerle doldurulmuş yeni bir dize döndürür.

Ayrıca bkz.

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