String.PadLeft Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

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

Overload

PadLeft(Int32)	Restituisce una nuova stringa che allinea a destra i caratteri in questa istanza mediante l'aggiunta a sinistra di un numero di spazi tale da ottenere la lunghezza totale specificata.
PadLeft(Int32, Char)	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.

PadLeft(Int32)

Restituisce una nuova stringa che allinea a destra i caratteri in questa istanza mediante l'aggiunta a sinistra di un numero di spazi tale da ottenere la lunghezza totale specificata.

public:
 System::String ^ PadLeft(int totalWidth);

public string PadLeft (int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (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 destra mediante l'aggiunta a sinistra 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 PadLeft metodo.

String^ str = "BBQ and Slaw";
Console::WriteLine( str->PadLeft( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine( str->PadLeft( 5 ) );  // Displays "BBQ and Slaw".

string str = "BBQ and Slaw";
Console.WriteLine(str.PadLeft(15));  // Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5));   // Displays "BBQ and Slaw".

Dim str As String
str = "BBQ and Slaw"
Console.WriteLine(str.PadLeft(15)) ' Displays "   BBQ and Slaw".
Console.WriteLine(str.PadLeft(5))  ' Displays "BBQ and Slaw".

Commenti

Uno spazio Unicode è definito come carattere esadecimale 0x0020.

Il PadLeft(Int32) metodo consente di riempire l'inizio della stringa restituita. Ciò significa che, se usato con le lingue da destra a sinistra, viene riempire la parte destra della stringa.

Nota

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

Vedi anche

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

PadLeft(Int32, Char)

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.

public:
 System::String ^ PadLeft(int totalWidth, char paddingChar);

public string PadLeft (int totalWidth, char paddingChar);

member this.PadLeft : int * char -> string

Public Function PadLeft (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 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.

Eccezioni

ArgumentOutOfRangeException

totalWidth è minore di zero.

Esempio

Nell'esempio seguente viene illustrato il PadLeft metodo.

using namespace System;

void main()
{
   String^ str = "forty-two";
   Console::WriteLine( str->PadLeft( 15, L'.' ) ); 
   Console::WriteLine( str->PadLeft( 2, L'.' ) ); 
}
// The example displays the following output:
//       ......forty-two
//       forty-two

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

Public Class Example
   Public Shared Sub Main()
      Dim str As String
      Dim pad As Char
      str = "forty-two"
      pad = "."c
      Console.WriteLine(str.PadLeft(15, pad)) 
      Console.WriteLine(str.PadLeft(2,  pad))
    End Sub
End Class
' The example displays the following output:
'       ......forty-two
'       forty-two

Commenti

Il PadLeft(Int32, Char) metodo consente di riempire l'inizio della stringa restituita. Ciò significa che, se usato con le lingue da destra a sinistra, viene riempire la parte destra della stringa.

Nota

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

Vedi anche

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