System Namespace   String Class

---

Right-aligns the characters in the given String, padding with spaces on the left for a specified total length.

[ VB ]
<Serializable>
Overloads Public Function PadLeft ( _
   ByVal totalWidth As Integer _
) As String

[ C# ]
[ Serializable ]
public string PadLeft (
   int totalWidth
);

[ C++ ]
[ Serializable ]
public: String* PadLeft (
   int totalWidth
);

[ JScript ]
public Serializable
function PadLeft (
   totalWidth : int
) : String;

totalWidth

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

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.

-or-If totalWidth is less than the length of this instance, a new String that is identical to this instance.

Exception Type	Condition
ArgumentException	totalWidth is less than zero.

A Unicode space is defined as hexadecimal 0x20.

[ VB ]
Dim str As String
str = "BBQ and Slaw"
Response.WriteLine ( str.PadLeft ( 15 ) ) ' Displays "   BBQ and Slaw".
Response.WriteLine ( str.PadLeft ( 5 ) ) ' Displays "BBQ and Slaw".

[ C++ ]
// Managed C++:
String *str = L"BBQ and Slaw";
Console::WriteLine ( str->PadLeft ( 15 ) ); // Displays "   BBQ and Slaw".
Console::WriteLine ( str->PadLeft ( 5 ) );  // Displays "BBQ and Slaw".

[ JScript ]
var str : String;
str = "BBQ and Slaw";
Response.WriteLine ( str.PadLeft ( 15 ) ); // Displays "   BBQ and Slaw".
Response.WriteLine ( str.PadLeft ( 5 ) );  // Displays "BBQ and Slaw".

String Members   String.PadLeft Overload List   Int32   PadRight   Trim

Suggested Reading