Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo String.PadLeft (Int32, Char)

 

Data di pubblicazione: ottobre 2016

Restituisce una nuova stringa che allinea a destra i caratteri in questa istanza mediante l'aggiunta a sinistra di una sequenza di elementi pari al carattere Unicode specificato, in modo da ottenere la lunghezza totale specificata.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public string PadLeft(
	int totalWidth,
	char paddingChar
)

Parametri

totalWidth
Type: System.Int32

Numero di caratteri nella stringa risultante che corrisponde alla somma del numero di caratteri originali e dei caratteri di riempimento aggiuntivi.

paddingChar
Type: System.Char

Carattere di riempimento Unicode.

Valore restituito

Type: System.String

Nuova stringa equivalente a questa istanza, ma allineata a destra mediante l'aggiunta a sinistra 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.

Exception Condition
ArgumentOutOfRangeException

totalWidth è minore di zero.

Il PadLeft(Int32, Char) metodo riempie l'inizio della stringa restituita. Ciò significa che, se utilizzato con le lingue da destra a sinistra, aggiunge la parte destra della stringa.

System_CAPS_noteNota

Se il PadLeft metodo aggiunge l'istanza corrente con spazi vuoti, questo metodo non modifica il valore dell'istanza corrente. Al contrario, restituisce una nuova stringa che viene riempita con iniziali paddingChar caratteri in modo che la lunghezza totale è totalWidth caratteri.

Nell'esempio seguente viene illustrato il PadLeft metodo.

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

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: