System.String.PadRight 方法 (Int32)
方法描述
返回一个新字符串，该字符串通过在此字符串中的字符右侧填充空格来达到指定的总长度，从而使这些字符左对齐。
语法定义(C# System.String.PadRight 方法 (Int32) 的用法)
public string PadRight( int totalWidth )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| totalWidth | System-Int32 | 结果字符串中的字符数，等于原始字符数加上任何其他填充字符。 |
| 返回值 | System.String | 与此实例等效的一个新字符串，但该字符串为左对齐，因此，在右侧填充所需任意数量的空格，使长度达到 totalWidth。 如果 totalWidth 小于此实例的长度，则为与此实例相同的新字符串。 |
提示和注释
Unicode 空格定义为十六进制的 0x20。
PadRight(Int32) 方法填充返回字符串的结尾。 这意味着当对从右向左的语言使用该方法时，它将填充字符串的左部。
注意
此方法不修改当前实例的值。 而是返回一个新字符串，其中填充了尾随空白以使字符串的总长度为 totalWidth 个字符。
System.String.PadRight 方法 (Int32)例子
下面的示例说明 PadRight 方法。
string str;
str = "BBQ and Slaw";
Console.Write("|");
Console.Write(str.PadRight(15));
Console.WriteLine("|"); // Displays "|BBQ and Slaw |".
Console.Write("|");
Console.Write(str.PadRight(5));
Console.WriteLine("|"); // Displays "|BBQ and Slaw|".
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentOutOfRangeException | totalWidth 小于零。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。