Click or drag to resize
StringPadLeft Method (Int32)
Returns a new string that right-aligns the characters in this instance by padding them with spaces on the left, for a specified total length.

Namespace: System
Assembly: mscorlib (in mscorlib.dll) Version: 4.0.0.0
Syntax
C#
public string PadLeft(
	int totalWidth
)

Parameters

totalWidth
Type: SystemInt32
The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.

Return Value

Type: String
A new string that is equivalent to this instance, but right-aligned and padded on the left with as many spaces as needed to create a length of totalWidth. However, if totalWidth is less than the length of this instance, the method returns a reference to the existing instance. If totalWidth is equal to the length of this instance, the method returns a new string that is identical to this instance.
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptiontotalWidth is less than zero.
See Also