String.PadRight Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Restituisce una nuova stringa di lunghezza specificata in cui la parte finale della stringa corrente è riempita con spazi o con una sequenza di elementi pari a un carattere Unicode specificato.

Overload

PadRight(Int32)	Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa mediante l'aggiunta a destra di un numero di spazi tale da ottenere la lunghezza totale specificata.
PadRight(Int32, Char)	Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa mediante l'aggiunta a destra di un carattere Unicode specificato, in modo da ottenere la lunghezza totale specificata.

PadRight(Int32)

Origine:

String.Manipulation.cs

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa mediante l'aggiunta a destra di un numero di spazi tale da ottenere la 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 che corrisponde alla somma del numero di caratteri originali e dei caratteri di riempimento aggiuntivi.

Restituisce

String

Nuova stringa equivalente a questa istanza, ma allineata a sinistra mediante l'aggiunta a destra di un numero di spazi tale da ottenere la lunghezza 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 = "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|".

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, riempie la parte sinistra della stringa.

Nota

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

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

PadRight(Int32, Char)

Origine:

String.Manipulation.cs

Restituisce una nuova stringa che allinea a sinistra i caratteri in questa stringa mediante l'aggiunta a destra di un carattere Unicode specificato, in modo da ottenere la 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 che corrisponde alla somma del numero di caratteri originali e dei caratteri di riempimento aggiuntivi.

paddingChar

Char

Carattere di riempimento Unicode.

Restituisce

String

Nuova stringa equivalente a questa istanza, ma allineata a sinistra mediante l'aggiunta a destra di un numero di caratteri paddingChar tale da ottenere la lunghezza 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";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".

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, riempie la parte sinistra della stringa.

Nota

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

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