列挙型書式指定文字列
ToString メソッドを使用すると、Enum の数値、16 進数値、または文字列値を表す文字列オブジェクトを新規作成できます。ToString メソッドでは、返す値を指定するために列挙型書式指定文字列が使用されます。
列挙型書式指定文字列と、各書式指定文字列が返す値の一覧を次の表に示します。列挙型書式指定子では、大文字と小文字は区別されません。
| 書式指定文字列 | 結果 |
|---|---|
G または g |
列挙型エントリを文字列値として表示できる場合は、文字列値として表示されます。文字列値として表示できない場合には、現在のインスタンスの整数値が表示されます。Flags 属性が設定されており、これによって列挙型が定義されている場合には、有効な各エントリの文字列値がコンマで区切られた形式で連結されます。Flags 属性が設定されていない場合には、無効な値が数値エントリとして表示されます。 |
F または f |
列挙エントリを文字列値として表示できる場合には、文字列値として表示されます。Flags 属性がない場合でも、列挙値の各エントリの合計値として値を完全に表示できる場合には、有効な各エントリの文字列値が、コンマで区切った形式で連結されます。列挙エントリによって値を完全に決定できない場合は、この値は整数値として書式指定されます。 |
D または d |
列挙エントリが、表現可能な最も短い整数値として表示されます。 |
X または x |
列挙エントリが 16 進数値として表示されます。最小桁数である 8 桁で値を表示するため、必要に応じて先行ゼロが埋め込まれます。 |
Red、Blue、および Green という 3 つのエントリから成る Colors という列挙値を定義する例を次に示します。
Public Enum Colors
Red = 1
Blue = 2
Green = 3
End Enum
public enum Colors{Red = 1, Blue = 2, Green = 3}
列挙値の定義が完了したら、次の方法でインスタンスを宣言できます。
Dim MyColors As Colors = Colors.Green
Colors MyColors = Colors.Green;
列挙型書式指定メソッドを使用して、DayOfWeek 列挙型の文字列表現、数値表現、および 16 進数表現を文字列 MyString に割り当てる例を次に示します。このコードでは、DayOfWeek 列挙型の新しいインスタンス MyDays を作成し、このインスタンスに値 Friday を代入します。次に、"G"、"F"、"D"、および "X" の書式指定文字列を使用して、それぞれの列挙表現を MyString に割り当てます。
Dim MyDays As DayOfWeek = DayOfWeek.Friday
Dim MyString As String = MyDays.ToString("G")
' In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("F")
' In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("D")
' In the U.S. English culture, MyString has the value: "5".
MyString = MyDays.ToString("X")
' In the U.S. English culture, MyString has the value: "00000005".
DayOfWeek MyDays = DayOfWeek.Friday;
String MyString = MyDays.ToString("G");
// In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("F");
// In the U.S. English culture, MyString has the value: "Friday".
MyString = MyDays.ToString("D");
// In the U.S. English culture, MyString has the value: "5".
MyString = MyDays.ToString("X");
// In the U.S. English culture, MyString has the value: "00000005".