指定した書式を使用して、このインスタンスの値をそれと等価な文字列形式に変換します。
Overloads Public Function ToString( _
ByVal format As String _) As String
[C#]
public string ToString(stringformat);
[C++]
public: String* ToString(String* format);
[JScript]
public function ToString(
format : String) : String;
パラメータ
- format
書式指定文字列。
戻り値
format により指定された、このインスタンスの値の文字列形式。
例外
例外の種類 | 条件 |
---|---|
FormatException | format に無効な指定が含まれています。 |
解説
format パラメータで指定できる書式指定文字は、"G" または "g"、"D" または "d"、"X" または "x"、および "F" または "f" です。 format が null 参照 (Visual Basic では Nothing) または空の文字列 ("") の場合は、一般書式指定子 ("G") が使用されます。これらの書式指定文字の詳細については、 Format メソッドの解説を参照してください。書式指定一般の詳細については、「 書式設定の概要 」を参照してください。
使用例
' Sample for Enum.ToString(String)
Imports System
Class Sample
Enum Colors
Red
Green
Blue
Yellow = 12
End Enum 'Colors
Public Shared Sub Main()
Dim myColor As Colors = Colors.Yellow
Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"))
Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"))
Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"))
Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"))
Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine)
Console.WriteLine("myColor.ToString(""g"") = {0}", myColor.ToString("g"))
Console.WriteLine("myColor.ToString(""G"") = {0}", myColor.ToString("G"))
Console.WriteLine("myColor.ToString(""x"") = {0}", myColor.ToString("x"))
Console.WriteLine("myColor.ToString(""X"") = {0}", myColor.ToString("X"))
Console.WriteLine("myColor.ToString(""d"") = {0}", myColor.ToString("d"))
Console.WriteLine("myColor.ToString(""D"") = {0}", myColor.ToString("D"))
Console.WriteLine("myColor.ToString(""f"") = {0}", myColor.ToString("f"))
Console.WriteLine("myColor.ToString(""F"") = {0}", myColor.ToString("F"))
End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'Colors.Red = 0
'Colors.Green = 1
'Colors.Blue = 2
'Colors.Yellow = 12
'
'myColor = Colors.Yellow
'
'myColor.ToString("g") = Yellow
'myColor.ToString("G") = Yellow
'myColor.ToString("x") = 0000000C
'myColor.ToString("X") = 0000000C
'myColor.ToString("d") = 12
'myColor.ToString("D") = 12
'myColor.ToString("f") = Yellow
'myColor.ToString("F") = Yellow
'
[C#]
// Sample for Enum.ToString(String)
using System;
class Sample
{
enum Colors {Red, Green, Blue, Yellow = 12};
public static void Main()
{
Colors myColor = Colors.Yellow;
Console.WriteLine("Colors.Red = {0}", Colors.Red.ToString("d"));
Console.WriteLine("Colors.Green = {0}", Colors.Green.ToString("d"));
Console.WriteLine("Colors.Blue = {0}", Colors.Blue.ToString("d"));
Console.WriteLine("Colors.Yellow = {0}", Colors.Yellow.ToString("d"));
Console.WriteLine("{0}myColor = Colors.Yellow{0}", Environment.NewLine);
Console.WriteLine("myColor.ToString(\"g\") = {0}", myColor.ToString("g"));
Console.WriteLine("myColor.ToString(\"G\") = {0}", myColor.ToString("G"));
Console.WriteLine("myColor.ToString(\"x\") = {0}", myColor.ToString("x"));
Console.WriteLine("myColor.ToString(\"X\") = {0}", myColor.ToString("X"));
Console.WriteLine("myColor.ToString(\"d\") = {0}", myColor.ToString("d"));
Console.WriteLine("myColor.ToString(\"D\") = {0}", myColor.ToString("D"));
Console.WriteLine("myColor.ToString(\"f\") = {0}", myColor.ToString("f"));
Console.WriteLine("myColor.ToString(\"F\") = {0}", myColor.ToString("F"));
}
}
/*
This example produces the following results:
Colors.Red = 0
Colors.Green = 1
Colors.Blue = 2
Colors.Yellow = 12
myColor = Colors.Yellow
myColor.ToString("g") = Yellow
myColor.ToString("G") = Yellow
myColor.ToString("x") = 0000000C
myColor.ToString("X") = 0000000C
myColor.ToString("d") = 12
myColor.ToString("D") = 12
myColor.ToString("f") = Yellow
myColor.ToString("F") = Yellow
*/
[C++]
// Sample for Enum::ToString(String)
#using <mscorlib.dll>
using namespace System;
__value enum Colors {Red, Green, Blue, Yellow = 12};
int main() {
Colors myColor = Colors::Yellow;
Console::WriteLine(S"Colors::Red = {0}", __box(Colors::Red)->ToString(S"d"));
Console::WriteLine(S"Colors::Green = {0}",__box( Colors::Green)->ToString(S"d"));
Console::WriteLine(S"Colors::Blue = {0}", __box(Colors::Blue)->ToString(S"d"));
Console::WriteLine(S"Colors::Yellow = {0}", __box(Colors::Yellow)->ToString(S"d"));
Console::WriteLine(S" {0}myColor = Colors::Yellow {0}", Environment::NewLine);
Console::WriteLine(S"myColor->ToString(\"g\") = {0}", __box(myColor)->ToString(S"g"));
Console::WriteLine(S"myColor->ToString(\"G\") = {0}", __box(myColor)->ToString(S"G"));
Console::WriteLine(S"myColor->ToString(\"x\") = {0}", __box(myColor)->ToString(S"x"));
Console::WriteLine(S"myColor->ToString(\"X\") = {0}", __box(myColor)->ToString(S"X"));
Console::WriteLine(S"myColor->ToString(\"d\") = {0}", __box(myColor)->ToString(S"d"));
Console::WriteLine(S"myColor->ToString(\"D\") = {0}", __box(myColor)->ToString(S"D"));
Console::WriteLine(S"myColor->ToString(\"f\") = {0}", __box(myColor)->ToString(S"f"));
Console::WriteLine(S"myColor->ToString(\"F\") = {0}", __box(myColor)->ToString(S"F"));
}
/*
This example produces the following results:
Colors::Red = 0
Colors::Green = 1
Colors::Blue = 2
Colors::Yellow = 12
myColor = Colors::Yellow
myColor->ToString("g") = Yellow
myColor->ToString("G") = Yellow
myColor->ToString("x") = 0000000C
myColor->ToString("X") = 0000000C
myColor->ToString("d") = 12
myColor->ToString("D") = 12
myColor->ToString("f") = Yellow
myColor->ToString("F") = Yellow
*/
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, Common Language Infrastructure (CLI) Standard
参照
Enum クラス | Enum メンバ | System 名前空間 | Enum.ToString オーバーロードの一覧 | 書式設定の概要 | 列挙型書式指定文字列 | Format | Parse