String.PadLeft 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 l'inizio della stringa corrente viene riempito con spazi o con un carattere Unicode specificato.

Overload

Nome Descrizione
PadLeft(Int32)

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

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

PadLeft(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 destra i caratteri in questa istanza inserendoli in spazi a sinistra per una 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, uguale al numero di caratteri originali più eventuali caratteri di riempimento aggiuntivi.

Valori restituiti

String

Nuova stringa equivalente a questa istanza, ma allineata a destra e riempita a sinistra 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 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".

let str = "BBQ and Slaw"
printfn $"{str.PadLeft 15}"  // Displays "   BBQ and Slaw".
printfn $"{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 viene definito come 0x0020 esadecimale.

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

Note

Se il PadLeft 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 iniziali in modo che la lunghezza totale sia totalWidth caratteri.

Vedi anche

Si applica a

PadLeft(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 destra i caratteri in questa istanza inserendoli a sinistra con un carattere Unicode specificato per una 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, 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 destra e riempita a sinistra 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 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

let str = "forty-two"
let pad = '.'

printfn $"{str.PadLeft(15, pad)}"
printfn $"{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 riempie l'inizio della stringa restituita. Ciò significa che, se usato con le lingue da destra a sinistra, si riempie la parte destra della stringa.

Note

Se il PadLeft 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 iniziali paddingChar in modo che la lunghezza totale sia totalWidth caratteri.

Vedi anche

Si applica a