Cadenas de formato de enumeración
Se puede emplear el método ToString para crear un nuevo objeto de cadena que represente el valor numérico, hexadecimal o de cadena de Enum. Este método toma una de las cadenas que dan formato a la enumeración para especificar el valor que se desea que se devuelva.
En la siguiente tabla se enumeran las cadenas que dan formato a la enumeración y los valores que devuelven. Estos especificadores de formato no hacen distinción entre mayúsculas y minúsculas.
| Cadena de formato | Resultado |
|---|---|
G o g |
Muestra la entrada de la enumeración como un valor de cadena, si es posible, y en caso contrario, muestra el valor de entero de la instancia actual. Si la enumeración se define con el conjunto de atributos Flags, los valores de cadena de cada entrada válida se concatenan juntos, separados por comas. Si no está establecido el atributo Flags, se muestra un valor no válido como una entrada numérica. |
F o f |
Muestra la entrada de enumeración como un valor de cadena si es posible. Si el valor se puede mostrar por completo como una sumatoria de las entradas de la enumeración (incluso si no está presente el atributo Flags), los valores de cadena de cada entrada válida se concatenan juntos, separados por comas. Si el valor no se puede determinar completamente con las entradas de la enumeración, entonces se le da formato al valor como valor de entero. |
D o d |
Muestra la entrada de enumeración como un valor de entero de la representación más corta posible. |
X o x |
Presenta la entrada de la enumeración como un valor hexadecimal. El valor se representa con tantos ceros iniciales como sea necesario para asegurar que el valor tenga un largo mínimo de ocho dígitos. |
En el siguiente ejemplo se define una enumeración denominada Colors que consta de tres entradas: Red, Blue y Green.
Public Enum Colors
Red = 1
Blue = 2
Green = 3
End Enum
public enum Colors{Red = 1, Blue = 2, Green = 3}
Una vez definida la enumeración, se declara una instancia de la manera siguiente.
Dim MyColors As Colors = Colors.Green
Colors MyColors = Colors.Green;
En el siguiente ejemplo se emplean los métodos para aplicar formato a la enumeración para asignar representaciones de cadena, numéricas y hexadecimales de una enumeración DayOfWeek a la cadena MyString. Este código crea una nueva instancia de la enumeración DayOfWeek denominada MyDays y le asigna el valor Friday. A continuación, se utilizan las cadenas de aplicación de formato "G", "F", "D" y "X" para asignar las distintas representaciones de enumeración a 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".