String.PadLeft Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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

Aşırı Yüklemeler

Name	Description
PadLeft(Int32)	Bu örnekteki karakterleri, belirtilen toplam uzunluk için soldaki boşluklarla doldurarak sağa hizalayan yeni bir dize döndürür.
PadLeft(Int32, Char)	Bu örnekteki karakterleri, belirtilen toplam uzunluk için, soldaki karakterleri belirtilen bir Unicode karakteriyle doldurarak sağ hizalayan yeni bir dize döndürür.

PadLeft(Int32)

Kaynak:

String.Manipulation.cs

Bu örnekteki karakterleri, belirtilen toplam uzunluk için soldaki 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

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 sağ hizalanmış ve uzunluğu oluşturmak için gereken sayıda boşlukla sol tarafa 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 PadLeft .

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.

Note

PadLeft 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 başında boşluk bulunan yeni bir dize döndürür.

Ayrıca bkz.

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

PadLeft(Int32, Char)

Kaynak:

String.Manipulation.cs

Bu örnekteki karakterleri, belirtilen toplam uzunluk için, soldaki karakterleri belirtilen bir Unicode karakteriyle doldurarak sağ 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

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 sağ paddingCharhizalanmış ve uzunluğu oluşturmak için gereken sayıda totalWidth karakterle sol tarafa doldurulmuş yeni bir dize. 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 PadLeft .

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.

Note

PadLeft 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 baştaki totalWidth karakterlerle doldurulmuş yeni bir dize döndürür.

Ayrıca bkz.

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