情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

String.PadLeft メソッド (Int32, Char)

2013/12/12

このインスタンス内の文字を右寄せし、指定した文字列の文字数になるまで、指定した Unicode 文字を左側に埋め込みます。

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public string PadLeft(
	int totalWidth,
	char paddingChar
)

パラメーター

totalWidth
型: System.Int32
結果として生成される文字列の文字数。これは、元の文字数と、埋め込み文字がある場合はその数を加えた数に等しくなります。
paddingChar
型: System.Char
Unicode 埋め込み文字。

戻り値

型: System.String
このインスタンスと等価な新しい文字列。この新しい文字列では文字が右寄せされ、totalWidth の長さになるまで左側に paddingChar の文字が埋め込まれています。ただし、totalWidth がこのインスタンスの長さより短い場合、このメソッドは既存のインスタンスへの参照を返します。totalWidth がこのインスタンスの長さに等しい場合、このメソッドはこのインスタンスと等しい新しい文字列を返します。

例外条件
ArgumentOutOfRangeException

totalWidth が 0 未満です。

PadLeft(Int32, Char) メソッドは、返された文字列の先頭に文字を埋め込みます。つまり、右から左に記述される言語で使用すると、文字列の右側が埋められることになります。

メモメモ:

このメソッドは、現在のインスタンスの値を変更しません。代わりに、文字数が totalWidth に指定した値になるまで先頭に paddingChar 文字を埋め込んだ新しい文字列を返します。

PadLeft メソッドのコード例を次に示します。


string str = "forty-two";
char pad = '.';

outputBlock.Text += String.Format(str.PadLeft(15, pad)) + "\n";    // Displays "......forty-two".
outputBlock.Text += String.Format(str.PadLeft(2, pad)) + "\n";     // Displays "forty-two".


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: