列舉型別格式字串
您可以使用 ToString 方法來建立表示數值、十六進位或 Enum 之字串值的新字串物件。這個方法接受列舉型別格式字串的其中之一來指定您想要傳回的值。
下表列出列舉型別格式字串和它們傳回的值。這些格式規範不區分大小寫。
| 格式字串 | 結果 |
|---|---|
G 或 g |
顯示列舉型別項目為字串值，如果可能的話，否則顯示目前執行個體的整數值。如果列舉型別因設定 Flags 屬性 (Attribute) 而被定義，各個有效項目的字串值都會以逗號分隔而串連在一起。如果 Flags 屬性未設定，無效值將顯示為數值項目。 |
F 或 f |
顯示列舉型別項目為字串值，如果可能的話。如果值可以完整顯示為列舉型別中項目的總和 (即使 Flags 屬性不出現)，各個有效項目的字串值都會以逗號分隔而串連在一起。如果值無法完全由列舉型別項目來決定，那麼這值便會格式化為整數值。 |
D 或 d |
以盡可能簡短的表示，將列舉型別項目顯示為整數值。 |
X 或 x |
顯示列舉型別項目為十六進位值。值以必要的前置零字元來表示，以確保這值最少有八位數長度。 |
下列範例定義稱為 Colors 的列舉型別，它由三個項目組成：Red、Blue 和 Green。
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 列舉型別的字串、數值和十六進位表示指派給字串 MyString。這個程式碼建立名為 MyDays 之 DayOfWeek 型別的新執行個體，並指派 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".