String.PadRight

.NET Framework クラス ライブラリ リファレンス

String.PadRight メソッド (Int32)

この文字列の文字を左寄せし、指定された文字列の長さになるまで、右側に空白を埋め込みます。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function PadRight ( _
    totalWidth As Integer _
) As String

Visual Basic (使用法)

Dim instance As String
Dim totalWidth As Integer
Dim returnValue As String

returnValue = instance.PadRight(totalWidth)

C#

public string PadRight (
    int totalWidth
)

C++

public:
String^ PadRight (
    int totalWidth
)

J#

public String PadRight (
    int totalWidth
)

JScript

public function PadRight (
    totalWidth : int
) : String

パラメータ

totalWidth

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

戻り値
このインスタンスと等価な新しい String。この新しいインスタンスでは文字が左寄せされ、totalWidth の長さになるまで右側に空白が埋め込まれています。または、totalWidth がこのインスタンスの長さより短い場合は、このインスタンスと等しい新しい String。

例外

例外の種類	条件
ArgumentException	totalWidth が 0 未満です。

解説

Unicode の空白文字は、16 進数で 0x20 と定義されています。

使用例

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

Visual Basic

Dim str As String
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|".

C++

String^ 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|".

JScript

var str : String;
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|".

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Int32 構造体
PadLeft
Trim

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

この文字列の文字を左寄せし、指定した長さになるまで、指定した Unicode 文字を右側に埋め込みます。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function PadRight ( _
    totalWidth As Integer, _
    paddingChar As Char _
) As String

Visual Basic (使用法)

Dim instance As String
Dim totalWidth As Integer
Dim paddingChar As Char
Dim returnValue As String

returnValue = instance.PadRight(totalWidth, paddingChar)

C#

public string PadRight (
    int totalWidth,
    char paddingChar
)

C++

public:
String^ PadRight (
    int totalWidth, 
    wchar_t paddingChar
)

J#

public String PadRight (
    int totalWidth, 
    char paddingChar
)

JScript

public function PadRight (
    totalWidth : int, 
    paddingChar : char
) : String

パラメータ

totalWidth

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

paddingChar

Unicode 埋め込み文字。

戻り値
このインスタンスと等価な新しい String。この新しいインスタンスでは文字が左寄せされ、totalWidth の長さになるまで右側に paddingChar の文字が埋め込まれています。または、totalWidth がこのインスタンスの長さより短い場合は、このインスタンスと等しい新しい String。

例外

例外の種類	条件
ArgumentException	totalWidth が 0 未満です。

使用例

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

Visual Basic

Dim str As String
Dim pad As Char
str = "forty-two"
pad = Convert.ToChar(".") 
Console.WriteLine(str.PadRight(15, pad)) ' Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)) ' Displays "|forty-two|".

C++

String^ str = "forty-two";
Console::Write( "|" );
Console::Write( str->PadRight( 15, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two......|".
Console::Write( "|" );
Console::Write( str->PadRight( 5, '.' ) );
Console::WriteLine( "|" ); // Displays "|forty-two|".

JScript

var str : String = "forty-two";
var pad : char = ".";
Console.WriteLine(str.PadRight(15, pad)); // Displays "|forty-two......|".
Console.WriteLine(str.PadRight(2,  pad)); // Displays "|forty-two|".

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Char 構造体
Int32 構造体
PadLeft
Trim

String.PadRight メソッド

この文字列の文字を左寄せし、指定した文字列の文字数になるまで、指定した Unicode 文字または空白を右側に埋め込みます。
オーバーロードの一覧

名前	説明
String.PadRight (Int32)	この文字列の文字を左寄せし、指定された文字列の長さになるまで、右側に空白を埋め込みます。 .NET Compact Framework によってサポートされています。
String.PadRight (Int32, Char)	この文字列の文字を左寄せし、指定した長さになるまで、指定した Unicode 文字を右側に埋め込みます。 .NET Compact Framework によってサポートされています。

参照

関連項目

String クラス
String メンバ
System 名前空間
Int32 構造体
PadLeft
Trim