String.PadRight 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 slutet av den aktuella strängen är vadderad med blanksteg eller med ett angivet Unicode-tecken.

Överlagringar

Name Description
PadRight(Int32)

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

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

PadRight(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 vänsterjusterar tecknen i den här strängen genom att ersätta dem med blanksteg till höger för en angiven total längd.

public:
 System::String ^ PadRight(int totalWidth);
public string PadRight(int totalWidth);
member this.PadRight : int -> string
Public Function PadRight (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 vänsterjusterad och vadderad till höger 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 PadRight metoden.

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

let str = "BBQ and Slaw"

printf "|"
printf $"{str.PadRight 15}"
printfn "|"       // Displays "|BBQ and Slaw   |".

printf "|"
printf $"{str.PadRight 5}"
printfn "|"       // 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|".

Kommentarer

Ett Unicode-blanksteg definieras som hexadecimalt 0x0020.

Metoden PadRight(Int32) fyller slutet 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å den vänstra delen av strängen.

Note

PadRight 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 avslutande blanksteg så att dess totala längd är totalWidth tecken.

Se även

Gäller för

PadRight(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 vänsterjusterar tecknen i den här strängen genom att ersätta dem till höger med ett angivet Unicode-tecken för en angiven total längd.

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

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 vänsterjusterad och vadderad till höger 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 PadRight metoden.

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

Console.WriteLine(str.PadRight(15, pad));    // Displays "forty-two......".
Console.WriteLine(str.PadRight(2,  pad));    // Displays "forty-two".

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

printfn $"{str.PadRight(15, pad)}"    // Displays "forty-two......".
printfn $"{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|".

Kommentarer

Metoden PadRight(Int32, Char) fyller slutet 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å den vänstra delen av strängen.

Note

PadRight 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 avslutande paddingChar tecken så att dess totala längd är totalWidth tecken.

Se även

Gäller för