String.PadRight Metodo

Definizione

Spazio dei nomi:
System
Assembly:
mscorlib.dll, System.Runtime.dll
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Restituisce una nuova stringa di lunghezza specificata in cui la fine della stringa corrente viene riempita con spazi o con un carattere Unicode specificato.

Overload

Nome Descrizione
PadRight(Int32)

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa inserendoli in spazi a destra per una lunghezza totale specificata.
PadRight(Int32, Char)

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa inserendoli a destra con un carattere Unicode specificato, per una lunghezza totale specificata.

PadRight(Int32)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa inserendoli in spazi a destra per una lunghezza totale specificata.

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

Parametri

totalWidth
Int32

Numero di caratteri nella stringa risultante, uguale al numero di caratteri originali più eventuali caratteri di riempimento aggiuntivi.

Valori restituiti

String

Nuova stringa equivalente a questa istanza, ma allineata a sinistra e riempita a destra con il numero di spazi necessario per creare una lunghezza di totalWidth. Tuttavia, se totalWidth è minore della lunghezza di questa istanza, il metodo restituisce un riferimento all'istanza esistente. Se totalWidth è uguale alla lunghezza di questa istanza, il metodo restituisce una nuova stringa identica a questa istanza.

Eccezioni

ArgumentOutOfRangeException

totalWidth è minore di zero.

Esempio

Nell'esempio seguente viene illustrato il PadRight metodo .

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

Commenti

Uno spazio Unicode viene definito come 0x0020 esadecimale.

Il PadRight(Int32) metodo riempie la fine della stringa restituita. Ciò significa che, se usato con le lingue da destra a sinistra, viene usata la parte sinistra della stringa.

Note

Se il PadRight metodo riempie l'istanza corrente con spazi vuoti, questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa riempita con spazi vuoti finali in modo che la lunghezza totale sia totalWidth di caratteri.

Vedi anche

Si applica a

PadRight(Int32, Char)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa inserendoli a destra con un carattere Unicode specificato, per una lunghezza totale specificata.

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

Parametri

totalWidth
Int32

Numero di caratteri nella stringa risultante, uguale al numero di caratteri originali più eventuali caratteri di riempimento aggiuntivi.

paddingChar
Char

Carattere di spaziatura interna Unicode.

Valori restituiti

String

Nuova stringa equivalente a questa istanza, ma allineata a sinistra e riempita a destra con il numero di paddingChar caratteri necessario per creare una lunghezza di totalWidth. Tuttavia, se totalWidth è minore della lunghezza di questa istanza, il metodo restituisce un riferimento all'istanza esistente. Se totalWidth è uguale alla lunghezza di questa istanza, il metodo restituisce una nuova stringa identica a questa istanza.

Eccezioni

ArgumentOutOfRangeException

totalWidth è minore di zero.

Esempio

Nell'esempio seguente viene illustrato il PadRight metodo .

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

Commenti

Il PadRight(Int32, Char) metodo riempie la fine della stringa restituita. Ciò significa che, se usato con le lingue da destra a sinistra, viene usata la parte sinistra della stringa.

Note

Se il PadRight metodo riempie l'istanza corrente con spazi vuoti, questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa riempita con caratteri finali paddingChar in modo che la lunghezza totale sia totalWidth di caratteri.

Vedi anche

Si applica a