String.PadRight Method (Int32)
Returns a new string that left-aligns the characters in this string by padding them with spaces on the right, for a specified total length.
Assembly: mscorlib (in mscorlib.dll)
- Type: System.Int32
The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.
Return ValueType: System.String
A new string that is equivalent to this instance, but left-aligned and padded on the right 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.
A Unicode space is defined as hexadecimal 0x0020.
The method pads the end of the returned string. This means that, when used with right-to-left languages, it pads the left portion of the string.
This method does not modify the value of the current instance. Instead, it returns a new string that is padded with trailing white space so that its total length is totalWidth characters.
The following example demonstrates the PadRight method.
.NET FrameworkSupported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1
.NET Framework Client ProfileSupported in: 4, 3.5 SP1
XNA FrameworkSupported in: 3.0, 2.0, 1.0
Portable Class LibrarySupported in: Portable Class Library
Supported in: Windows Phone 8.1
Supported in: Windows Phone Silverlight 8.1
Supported in: Windows Phone Silverlight 8