String.PadLeft Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Geçerli dizenin başlangıcının boşluklarla veya belirtilen Unicode karakterle dolduruldığı, belirtilen uzunlukta yeni bir dize döndürür.

Aşırı Yüklemeler

PadLeft(Int32, Char)	Bu örnekteki karakterleri belirtilen toplam uzunluk için belirtilen unicode karakterle sol tarafa doldurarak bu örnekteki karakterleri sağa hizalayan yeni bir dize döndürür.
PadLeft(Int32)	Belirtilen toplam uzunluk için bu örnekteki karakterleri solda boşluklarla doldurarak sağa hizalayan yeni bir dize döndürür.

PadLeft(Int32, Char)

Kaynak:

String.Manipulation.cs

Bu örnekteki karakterleri belirtilen toplam uzunluk için belirtilen unicode karakterle sol tarafa doldurarak bu örnekteki karakterleri sağa hizalayan 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 uzunluğu oluşturmak için gereken sayıda paddingChar karakterle sağa hizalanmış ve sola doldurulmuş yeni bir totalWidthdize. Ancak, bu örneğin uzunluğundan küçükse totalWidth , yöntemi 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 PadLeft .

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

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

printfn $"{str.PadLeft(15, pad)}"
printfn $"{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

yöntemi, PadLeft(Int32, Char) döndürülen dizenin başlangıcını ekler. Bu, sağdan sola dillerle kullanıldığında dizenin sağ bölümünü doldurması anlamına gelir.

Not

PadLeft Yöntem geçerli örneği boşluk karakterleriyle kaplarsa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğunun totalWidth karakter olması için baştaki paddingChar karakterlerle doldurulmuş yeni bir dize döndürür.

Ayrıca bkz.

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

PadLeft(Int32)

Kaynak:

String.Manipulation.cs

Belirtilen toplam uzunluk için bu örnekteki karakterleri solda boşluklarla doldurarak sağa hizalayan 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 uzunluğu oluşturmak için gereken sayıda boşlukla sağa hizalanmış ve sola doldurulmuş yeni bir totalWidthdize. Ancak, bu örneğin uzunluğundan küçükse totalWidth , yöntemi 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 PadLeft .

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

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{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 0x0020 olarak tanımlanır.

yöntemi, PadLeft(Int32) döndürülen dizenin başlangıcını ekler. Bu, sağdan sola dillerle kullanıldığında dizenin sağ bölümünü doldurması anlamına gelir.

Not

PadLeft Yöntem geçerli örneği boşluk karakterleriyle kaplarsa, bu yöntem geçerli örneğin değerini değiştirmez. Bunun yerine, toplam uzunluğunun totalWidth karakter olması için başında boşluk bulunan yeni bir dize döndürür.

Ayrıca bkz.

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