String.PadLeft 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 başlangıcının boşluklarla veya belirtilen Unicode karakteriyle doldurulmuş olduğu belirtilen uzunlukta yeni bir dize döndürür.

Aşırı Yüklemeler

PadLeft(Int32)

Bu örnekteki karakterlerin, belirtilen toplam uzunluk için sol taraftaki boşluklar ile doldurmasını sağlayan yeni bir dize döndürür.
PadLeft(Int32, Char)

Belirtilen toplam uzunluk için, belirtilen bir Unicode karakteriyle sola doldurarak bu örnekteki karakterlerin sağına doğru şekilde hizalandığını belirten yeni bir dize döndürür.

PadLeft(Int32)

Bu örnekteki karakterlerin, belirtilen toplam uzunluk için sol taraftaki boşluklar ile doldurmasını sağlayan yeni bir dize döndürür.

public:
 System::String ^ PadLeft(int totalWidth);
public string PadLeft (int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (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 sola doldurulan 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 PadLeft yöntemini gösterir.

String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) );  // Displays "BBQ and Slaw".

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(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".

Açıklamalar

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

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

Not

PadLeftYö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, baştaki boşluk ile doldurulmuş yeni bir dize döndürür totalWidth .

Ayrıca bkz.

Şunlara uygulanır

PadLeft(Int32, Char)

Belirtilen toplam uzunluk için, belirtilen bir Unicode karakteriyle sola doldurarak bu örnekteki karakterlerin sağına doğru şekilde hizalandığını belirten yeni bir dize döndürür.

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

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 örneğe eşdeğer, ancak sola hizalanmış ve paddingChar uzunluğu oluşturmak için gereken sayıda karakter içeren 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 PadLeft yöntemini gösterir.

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two

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

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

Açıklamalar

PadLeft(Int32, Char)Yöntemi döndürülen dizenin başlangıcını defterler. Bu, sağdan sola dillerin kullanıldığı durumlarda dizenin sağ bölümünün bulunduğu anlamına gelir.

Not

PadLeftYö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 öndeki karakterlerle doldurulan yeni bir dize döndürür paddingChar totalWidth .

Ayrıca bkz.

Şunlara uygulanır