String.PadLeft Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een nieuwe tekenreeks van een opgegeven lengte waarin het begin van de huidige tekenreeks wordt opgevuld met spaties of met een opgegeven Unicode-teken.

Overloads

Name	Description
PadLeft(Int32)	Retourneert een nieuwe tekenreeks die de tekens in dit exemplaar rechts uitlijnt door deze op te vulling met spaties aan de linkerkant, voor een opgegeven totale lengte.
PadLeft(Int32, Char)	Retourneert een nieuwe tekenreeks die de tekens in dit exemplaar rechts uitlijnt door deze links op te vulling met een opgegeven Unicode-teken voor een opgegeven totale lengte.

PadLeft(Int32)

Retourneert een nieuwe tekenreeks die de tekens in dit exemplaar rechts uitlijnt door deze op te vulling met spaties aan de linkerkant, voor een opgegeven totale lengte.

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

public string PadLeft(int totalWidth);

member this.PadLeft : int -> string

Public Function PadLeft (totalWidth As Integer) As String

Parameters

totalWidth: Int32

Het aantal tekens in de resulterende tekenreeks, gelijk aan het aantal oorspronkelijke tekens plus eventuele extra opvullingstekens.

Retouren

String

Een nieuwe tekenreeks die gelijk is aan dit exemplaar, maar rechts uitgelijnd en opgevuld aan de linkerkant met zoveel spaties als nodig is om een lengte van totalWidth. Als totalWidth deze instantie echter kleiner is dan de lengte van dit exemplaar, retourneert de methode een verwijzing naar het bestaande exemplaar. Als totalWidth deze gelijk is aan de lengte van dit exemplaar, retourneert de methode een nieuwe tekenreeks die identiek is aan dit exemplaar.

Uitzonderingen

ArgumentOutOfRangeException

totalWidth is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u de PadLeft methode.

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

Opmerkingen

Een Unicode-ruimte wordt gedefinieerd als hexadecimale 0x0020.

Met PadLeft(Int32) de methode wordt het begin van de geretourneerde tekenreeks opgevuld. Dit betekent dat, wanneer deze wordt gebruikt met talen die van rechts naar links worden gebruikt, het rechtergedeelte van de tekenreeks opvult.

Note

Als de methode het PadLeft huidige exemplaar met spatietekens opvult, wijzigt deze methode de waarde van het huidige exemplaar niet. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd die is opgevuld met voorloopspaties, zodat de totale lengte tekens is totalWidth .

Zie ook

Van toepassing op

PadLeft(Int32, Char)

Retourneert een nieuwe tekenreeks die de tekens in dit exemplaar rechts uitlijnt door deze links op te vulling met een opgegeven Unicode-teken voor een opgegeven totale lengte.

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

Parameters

totalWidth: Int32

Het aantal tekens in de resulterende tekenreeks, gelijk aan het aantal oorspronkelijke tekens plus eventuele extra opvullingstekens.

paddingChar: Char

Een Unicode-opvullingsteken.

Retouren

String

Een nieuwe tekenreeks die gelijk is aan dit exemplaar, maar rechts uitgelijnd en opgevuld aan de linkerkant met zoveel paddingChar tekens als nodig is om een lengte van totalWidth. Als totalWidth deze instantie echter kleiner is dan de lengte van dit exemplaar, retourneert de methode een verwijzing naar het bestaande exemplaar. Als totalWidth deze gelijk is aan de lengte van dit exemplaar, retourneert de methode een nieuwe tekenreeks die identiek is aan dit exemplaar.

Uitzonderingen

ArgumentOutOfRangeException

totalWidth is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u de PadLeft methode.

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

Opmerkingen

Met PadLeft(Int32, Char) de methode wordt het begin van de geretourneerde tekenreeks opgevuld. Dit betekent dat, wanneer deze wordt gebruikt met talen die van rechts naar links worden gebruikt, het rechtergedeelte van de tekenreeks opvult.

Note

Als de methode het PadLeft huidige exemplaar met spatietekens opvult, wijzigt deze methode de waarde van het huidige exemplaar niet. In plaats daarvan wordt een nieuwe tekenreeks geretourneerd die is opgevuld met voorlooptekens paddingChar , zodat de totale lengte tekens is totalWidth .

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?