String.PadRight Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Retourneert een nieuwe tekenreeks van een opgegeven lengte waarin het einde van de huidige tekenreeks wordt opgevuld met spaties of met een opgegeven Unicode-teken.

Overloads

Name Description
PadRight(Int32)

Retourneert een nieuwe tekenreeks die de tekens in deze tekenreeks links uitlijnt door deze op te vulling met spaties aan de rechterkant, voor een opgegeven totale lengte.
PadRight(Int32, Char)

Retourneert een nieuwe tekenreeks die de tekens in deze tekenreeks links uitlijnt door deze aan de rechterkant op te vulling met een opgegeven Unicode-teken, voor een opgegeven totale lengte.

PadRight(Int32)

Retourneert een nieuwe tekenreeks die de tekens in deze tekenreeks links uitlijnt door deze op te vulling met spaties aan de rechterkant, voor een opgegeven totale lengte.

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

Parameters

totalWidth
Int32

Het aantal tekens in de resulterende tekenreeks, gelijk aan het aantal oorspronkelijke tekens plus eventuele extra opvullingstekens.

Retouren

String

Een nieuwe tekenreeks die gelijk is aan dit exemplaar, maar links uitgelijnd en opgevuld aan de rechterkant met zoveel spaties als nodig is om een lengte van totalWidth. Als totalWidth deze instantie echter kleiner is dan de lengte van dit exemplaar, retourneert de methode een verwijzing naar het bestaande exemplaar. Als totalWidth deze gelijk is aan de lengte van dit exemplaar, retourneert de methode een nieuwe tekenreeks die identiek is aan dit exemplaar.

Uitzonderingen

ArgumentOutOfRangeException

totalWidth is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u de PadRight methode.

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

Opmerkingen

Een Unicode-ruimte wordt gedefinieerd als hexadecimale 0x0020.

Met PadRight(Int32) de methode wordt het einde van de geretourneerde tekenreeks opgevuld. Dit betekent dat bij gebruik met talen die van rechts naar links worden gebruikt, het linkergedeelte van de tekenreeks wordt gebruikt.

Note

Als de methode het PadRight huidige exemplaar met spatietekens opvult, wijzigt deze methode de waarde van het huidige exemplaar niet. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd die is opgevuld met volgspaties, zodat de totale lengte tekens is totalWidth .

Zie ook

Van toepassing op

PadRight(Int32, Char)

Retourneert een nieuwe tekenreeks die de tekens in deze tekenreeks links uitlijnt door deze aan de rechterkant op te vulling met een opgegeven Unicode-teken, voor een opgegeven totale lengte.

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

Parameters

totalWidth
Int32

Het aantal tekens in de resulterende tekenreeks, gelijk aan het aantal oorspronkelijke tekens plus eventuele extra opvullingstekens.

paddingChar
Char

Een Unicode-opvullingsteken.

Retouren

String

Een nieuwe tekenreeks die gelijk is aan dit exemplaar, maar links uitgelijnd en opgevuld aan de rechterkant met zoveel paddingChar tekens als nodig is om een lengte van totalWidth. Als totalWidth deze instantie echter kleiner is dan de lengte van dit exemplaar, retourneert de methode een verwijzing naar het bestaande exemplaar. Als totalWidth deze gelijk is aan de lengte van dit exemplaar, retourneert de methode een nieuwe tekenreeks die identiek is aan dit exemplaar.

Uitzonderingen

ArgumentOutOfRangeException

totalWidth is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u de PadRight methode.

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

Opmerkingen

Met PadRight(Int32, Char) de methode wordt het einde van de geretourneerde tekenreeks opgevuld. Dit betekent dat bij gebruik met talen die van rechts naar links worden gebruikt, het linkergedeelte van de tekenreeks wordt gebruikt.

Note

Als de methode het PadRight huidige exemplaar met spatietekens opvult, wijzigt deze methode de waarde van het huidige exemplaar niet. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd die is opgevuld met volgtekens paddingChar , zodat de totale lengte tekens is totalWidth .

Zie ook

Van toepassing op