String.PadLeft Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Returnerar en ny sträng med en angiven längd där början av den aktuella strängen är vadderad med blanksteg eller med ett angivet Unicode-tecken.

Överlagringar

Name Description
PadLeft(Int32)

Returnerar en ny sträng som högerjusterar tecknen i den här instansen genom att ersätta dem med blanksteg till vänster för en angiven total längd.
PadLeft(Int32, Char)

Returnerar en ny sträng som högerjusterar tecknen i den här instansen genom att ersätta dem till vänster med ett angivet Unicode-tecken för en angiven total längd.

PadLeft(Int32)

Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs

Returnerar en ny sträng som högerjusterar tecknen i den här instansen genom att ersätta dem med blanksteg till vänster för en angiven total längd.

public:
 System::String ^ PadLeft(int totalWidth);
public string PadLeft(int totalWidth);
member this.PadLeft : int -> string
Public Function PadLeft (totalWidth As Integer) As String

Parametrar

totalWidth
Int32

Antalet tecken i den resulterande strängen, lika med antalet originaltecken plus eventuella ytterligare utfyllnadstecken.

Returer

String

En ny sträng som motsvarar den här instansen, men högerjusterad och vadderad till vänster med så många blanksteg som behövs för att skapa en längd på totalWidth. Men om totalWidth är mindre än längden på den här instansen returnerar metoden en referens till den befintliga instansen. Om totalWidth är lika med längden på den här instansen returnerar metoden en ny sträng som är identisk med den här instansen.

Undantag

ArgumentOutOfRangeException

totalWidth är mindre än noll.

Exempel

I följande exempel visas PadLeft metoden.

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

Kommentarer

Ett Unicode-blanksteg definieras som hexadecimalt 0x0020.

Metoden PadLeft(Int32) fyller i början av den returnerade strängen. Det innebär att när det används med höger-till-vänster-språk fyller det på höger del av strängen.

Note

PadLeft Om metoden fyller ut den aktuella instansen med blankstegstecken ändrar den här metoden inte värdet för den aktuella instansen. I stället returneras en ny sträng som är vadderad med inledande blanksteg så att dess totala längd är totalWidth tecken.

Se även

Gäller för

PadLeft(Int32, Char)

Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs
Källa:
String.Manipulation.cs

Returnerar en ny sträng som högerjusterar tecknen i den här instansen genom att ersätta dem till vänster med ett angivet Unicode-tecken för en angiven total längd.

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

Parametrar

totalWidth
Int32

Antalet tecken i den resulterande strängen, lika med antalet originaltecken plus eventuella ytterligare utfyllnadstecken.

paddingChar
Char

Ett Unicode-utfyllnadstecken.

Returer

String

En ny sträng som motsvarar den här instansen, men högerjusterad och vadderad till vänster med så många paddingChar tecken som behövs för att skapa en längd på totalWidth. Men om totalWidth är mindre än längden på den här instansen returnerar metoden en referens till den befintliga instansen. Om totalWidth är lika med längden på den här instansen returnerar metoden en ny sträng som är identisk med den här instansen.

Undantag

ArgumentOutOfRangeException

totalWidth är mindre än noll.

Exempel

I följande exempel visas PadLeft metoden.

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

Kommentarer

Metoden PadLeft(Int32, Char) fyller i början av den returnerade strängen. Det innebär att när det används med höger-till-vänster-språk fyller det på höger del av strängen.

Note

PadLeft Om metoden fyller ut den aktuella instansen med blankstegstecken ändrar den här metoden inte värdet för den aktuella instansen. I stället returneras en ny sträng som är vadderad med inledande paddingChar tecken så att dess totala längd är totalWidth tecken.

Se även

Gäller för