El método Enum.Format(Type, Object, String) se utiliza para convertir el valor especificado de un tipo enumerado especificado en su representación de string equivalente según el formato especificado.
Sintaxis:
public static string Format (Type enumType, object value, string format);
Parámetros:
- enumType: Es el tipo de enumeración del valor a convertir.
- valor: Es el valor a convertir.
- formato: Es el formato de salida a utilizar.
Devoluciones: este método devuelve la representación de string de valor.
Excepciones:
- ArgumentNullException: si el parámetro enumType , value o format es nulo.
- ArgumentException: si el parámetro enumType no es un tipo Enum o el valor es de una enumeración que difiere en tipo de enumType o el tipo de valor no es un tipo subyacente de enumType.
- FormatException: si el parámetro de formato contiene un valor no válido.
- InvalidOperationException: si el formato es igual a «X», pero se desconoce el tipo de enumeración.
Los siguientes programas ilustran el uso del método mencionado anteriormente.
Ejemplo 1:
// C# program to illustrate the // Enum.Format(Type, Object, // String) Method using System; enum Animals { Dog, Cat, Cow }; class GFG { // Main Method public static void Main(String[] args) { Animals fav = Animals.Cat; Console.WriteLine("My favorite Animal is {0}.", fav); // using the Method and here // "d" specify the value in // decimal form. Console.WriteLine("The value of my favorite Animal is {0}.", Enum.Format(typeof(Animals), fav, "d")); // using the Method and here // "x" specify the value in // hexadecimal form. Console.WriteLine("The hex value of my Animal is {0}.", Enum.Format(typeof(Animals), fav, "x")); } }
My favorite Animal is Cat. The value of my favorite Animal is 1. The hex value of my Animal is 00000001.
Ejemplo 2:
// C# program to illustrate the // Enum.Format(Type, Object, // String) Method using System; enum Animals { Dog, Cat, Cow }; class GFG { // Main Method public static void Main() { Animals fav = Animals.Cat; Console.WriteLine("My favorite Animal is {0}.", fav); // using the Method and format is null // thats why it give exception Console.WriteLine("The value of my favorite Animal is {0}.", Enum.Format(typeof(Animals), fav, null)); } }
Error de tiempo de ejecución:
Excepción no controlada:
System.ArgumentNullException: el valor no puede ser nulo.
Nombre del parámetro: formato
Nota: A continuación se muestran algunos valores válidos para el parámetro de formato.
- “D o “d”: Representa el parámetro de valor en forma decimal.
- “X” o “x”: Representa el parámetro de valor en formato hexadecimal. No lleva “0x”.
Referencia:
Publicación traducida automáticamente
Artículo escrito por ankita_saini y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA