Aracılığıyla paylaş

String.PadRight Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
netstandard.dll
Bütünleştirilmiş Kod:
mscorlib.dll

Geçerli dizenin sonundaki boşluk veya belirtilen Unicode karakteri ile doldurulmuş belirtilen uzunlukta yeni bir dize döndürür.

Aşırı Yüklemeler

PadRight(Int32)

Bu dizedeki karakterleri, belirtilen toplam uzunluk için sağdaki boşluklar ile doldurarak sola hizalayan yeni bir dize döndürür.
PadRight(Int32, Char)

Bu dizedeki karakterleri belirtilen toplam uzunluk için belirtilen Unicode karakteriyle sağ tarafta doldurmayla sola hizalanmış yeni bir dize döndürür.

PadRight(Int32)

Bu dizedeki karakterleri, belirtilen toplam uzunluk için sağdaki boşluklar ile 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

Özgün karakterlere doldurma karakterleri eklendiğinde çıkan sayıya eşit olan, sonuç dizesindeki karakter sayısı.

Döndürülenler

String

Bu örneğe eşdeğer, ancak sola hizalanmış ve uzunluğu oluşturmak için gereken sayıda boşluk ile sağa doldurulmuş yeni bir dize totalWidth . Ancak, totalWidth Bu örneğin uzunluğundan küçükse, yöntemi mevcut örneğe bir başvuru döndürür. totalWidthBu örneğin uzunluğuna eşitse, 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 örnek PadRight yöntemini gösterir.

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

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

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 bir 0x0020 olarak tanımlanır.

PadRight(Int32)Yöntemi döndürülen dizenin sonunu defterler. Bu, sağdan sola dillerin kullanıldığı durumlarda dizenin sol bölümünün bulunduğu anlamına gelir.

Not

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

Ayrıca bkz.

Şunlara uygulanır

PadRight(Int32, Char)

Bu dizedeki karakterleri belirtilen toplam uzunluk için belirtilen Unicode karakteriyle sağ tarafta doldurmayla sola hizalanmış 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

Özgün karakterlere doldurma karakterleri eklendiğinde çıkan sayıya eşit olan, sonuç dizesindeki karakter sayısı.

paddingChar
Char

Unicode doldurma karakteri.

Döndürülenler

String

Bu örnekle eşdeğer olan ancak uzunluğu oluşturmak için gereken sayıda karakterle sola hizalanmış ve sağ tarafta yer alan paddingChar yeni bir totalWidth dize. Ancak, totalWidth bu örneğin uzunluğundan küçükse yöntemi var olan örnek için bir başvuru döndürür. Bu totalWidth örneğin uzunluğuna eşitse, 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 PadRight gösterildi.

String^ str = "forty-two";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".

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

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(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 dolgular. Bu, sağdan sola dillerle birlikte kullanılırken dizenin sol kısmının dolgus olduğu anlamına gelir.

Not

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

Ayrıca bkz.

Şunlara uygulanır