Enum.Parse Método

Definición

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente.

Sobrecargas

Parse(Type, ReadOnlySpan<Char>)

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente.

Parse(Type, String)

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente.

Parse(Type, ReadOnlySpan<Char>, Boolean)

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

Parse(Type, String, Boolean)

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

Parse<TEnum>(String, Boolean)

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

Parse<TEnum>(ReadOnlySpan<Char>, Boolean)

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

Parse<TEnum>(ReadOnlySpan<Char>)

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente.

Parse<TEnum>(String)

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente.

Parse(Type, ReadOnlySpan<Char>)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente.

public static object Parse (Type enumType, ReadOnlySpan<char> value);

Parámetros

enumType
Type

Tipo de enumeración.

value
ReadOnlySpan<Char>

Intervalo que contiene el nombre o el valor que se va a convertir.

Devoluciones

Objeto de tipo enumType cuyo valor se representa mediante value.

Excepciones

enumType es null.

enumType no es un Enum.

value es una cadena vacía o solo contiene espacios en blanco.

value es un nombre, pero no una de las constantes con nombre definidas para la enumeración.

value está fuera del intervalo del tipo subyacente de enumType.

.NET 8 y versiones posteriores: enumType es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9

Parse(Type, String)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente.

public static object Parse (Type enumType, string value);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value);

Parámetros

enumType
Type

Tipo de enumeración.

value
String

Cadena que contiene el nombre o el valor que se va a convertir.

Devoluciones

Objeto de tipo enumType cuyo valor se representa mediante value.

Atributos

Excepciones

enumType o value es null.

enumType no es un Enum.

-o-

value es una cadena vacía o solo contiene espacios en blanco.

-o-

value es un nombre, pero no una de las constantes con nombre definidas para la enumeración.

value está fuera del intervalo del tipo subyacente de enumType.

.NET 8 y versiones posteriores: enumType es un tipo de enumeración con respaldo booleano.

Ejemplos

En el ejemplo siguiente se usa el método Parse(Type, String) para analizar una matriz de cadenas que se crean llamando al método GetNames. También usa el método Parse(Type, String) para analizar un valor de enumeración que consta de un campo de bits.

using System;

public class ParseTest
{
    [Flags]
    enum Colors { Red = 1, Green = 2, Blue = 4, Yellow = 8 };

    public static void Main()
    {
        Console.WriteLine("The entries of the Colors enumeration are:");
        foreach (string colorName in Enum.GetNames(typeof(Colors)))
        {
            Console.WriteLine("{0} = {1:D}", colorName,
                                         Enum.Parse(typeof(Colors), colorName));
        }
        Console.WriteLine();

        Colors orange = (Colors) Enum.Parse(typeof(Colors), "Red, Yellow");
        Console.WriteLine("The orange value {0:D} has the combined entries of {0}",
                           orange);
    }
}

/*
This code example produces the following results:

The entries of the Colors Enum are:
Red = 1
Green = 2
Blue = 4
Yellow = 8

The orange value 9 has the combined entries of Red, Yellow

*/

Comentarios

El parámetro value contiene la representación de cadena del valor subyacente o constante con nombre de un miembro de enumeración, o una lista de constantes con nombre delimitadas por comas (,). Uno o varios espacios en blanco pueden preceder o seguir cada valor, nombre o coma en value. Si value es una lista, el valor devuelto es el valor de los nombres especificados combinados con una operación OR bit a bit.

Si value es un nombre que no corresponde a una constante con nombre de enumType, el método produce un ArgumentException. Si value es la representación de cadena de un entero que no representa un valor subyacente de la enumeración enumType, el método devuelve un miembro de enumeración cuyo valor subyacente se value convierte en un tipo entero. Si este comportamiento no es deseable, llame al método IsDefined para asegurarse de que una representación de cadena determinada de un entero es realmente miembro de enumType. En el ejemplo siguiente se define una enumeración Colors, se llama al método Parse(Type, String) para convertir cadenas en sus valores de enumeración correspondientes y llama al método IsDefined para asegurarse de que determinados valores enteros son valores subyacentes en la enumeración Colors.

using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         try {
            Colors colorValue = (Colors) Enum.Parse(typeof(Colors), colorString);
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         }
         catch (ArgumentException) {
            Console.WriteLine("'{0}' is not a member of the Colors enumeration.", colorString);
         }
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       'blue' is not a member of the Colors enumeration.
//       Converted 'Blue' to Blue.
//       'Yellow' is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

Esta operación distingue mayúsculas de minúsculas.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Parse(Type, ReadOnlySpan<Char>, Boolean)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

public static object Parse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase);

Parámetros

enumType
Type

Tipo de enumeración.

value
ReadOnlySpan<Char>

Intervalo que contiene el nombre o el valor que se va a convertir.

ignoreCase
Boolean

true omitir mayúsculas y minúsculas; false en lo que respecta al caso.

Devoluciones

Objeto de tipo enumType cuyo valor se representa mediante value.

Excepciones

enumType es null.

enumType no es un Enum.

value es una cadena vacía o solo contiene espacios en blanco.

value es un nombre, pero no una de las constantes con nombre definidas para la enumeración.

value está fuera del intervalo del tipo subyacente de enumType

.NET 8 y versiones posteriores: enumType es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9

Parse(Type, String, Boolean)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

public static object Parse (Type enumType, string value, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value, bool ignoreCase);

Parámetros

enumType
Type

Tipo de enumeración.

value
String

Cadena que contiene el nombre o el valor que se va a convertir.

ignoreCase
Boolean

true omitir mayúsculas y minúsculas; false en lo que respecta al caso.

Devoluciones

Objeto de tipo enumType cuyo valor se representa mediante value.

Atributos

Excepciones

enumType o value es null.

enumType no es un Enum.

-o-

value es una cadena vacía ("") o solo contiene espacios en blanco.

-o-

value es un nombre, pero no una de las constantes con nombre definidas para la enumeración.

value está fuera del intervalo del tipo subyacente de enumType.

.NET 8 y versiones posteriores: enumType es un tipo de enumeración con respaldo booleano.

Ejemplos

En el ejemplo siguiente se usa el método Parse(Type, String, Boolean) para analizar una matriz de cadenas que se crean llamando al método GetNames. También usa el método Parse(Type, String) para analizar un valor de enumeración que consta de un campo de bits.

using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         try {
            Colors colorValue = (Colors) Enum.Parse(typeof(Colors), colorString, true);
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         }
         catch (ArgumentException) {
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString);
         }
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       Converted 'blue' to Blue.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

Comentarios

El parámetro value contiene la representación de cadena del valor subyacente o constante con nombre de un miembro de enumeración, o una lista de constantes con nombre delimitadas por comas (,). Uno o varios espacios en blanco pueden preceder o seguir cada valor, nombre o coma en value. Si value es una lista, el valor devuelto es el valor de los nombres especificados combinados con una operación OR bit a bit.

Si value es un nombre que no corresponde a una constante con nombre de enumType, el método produce un ArgumentException. Si value es la representación de cadena de un entero que no representa un valor subyacente de la enumeración enumType, el método devuelve un miembro de enumeración cuyo valor subyacente se value convierte en un tipo entero. Si este comportamiento no es deseable, llame al método IsDefined para asegurarse de que una representación de cadena determinada de un entero es realmente miembro de enumType. En el ejemplo siguiente se define una enumeración Colors, se llama al método Parse(Type, String, Boolean) para convertir cadenas en sus valores de enumeración correspondientes y llama al método IsDefined para asegurarse de que determinados valores enteros son valores subyacentes en la enumeración Colors.

El parámetro ignoreCase especifica si esta operación distingue mayúsculas de minúsculas.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Parse<TEnum>(String, Boolean)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

public static TEnum Parse<TEnum> (string value, bool ignoreCase) where TEnum : struct;

Parámetros de tipo

TEnum

Tipo de enumeración.

Parámetros

value
String

Cadena que contiene el nombre o el valor que se va a convertir.

ignoreCase
Boolean

true omitir mayúsculas y minúsculas; false en lo que respecta al caso.

Devoluciones

TEnum

Objeto de tipo TEnum cuyo valor se representa mediante value.

Excepciones

TEnum no es un tipo de Enum.

value es null.

value no contiene información de enumeración.

.NET 8 y versiones posteriores: TEnum es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Parse<TEnum>(ReadOnlySpan<Char>, Boolean)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente. Un parámetro especifica si la operación no distingue mayúsculas de minúsculas.

public static TEnum Parse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase) where TEnum : struct;

Parámetros de tipo

TEnum

Tipo de enumeración.

Parámetros

value
ReadOnlySpan<Char>

Intervalo que contiene el nombre o el valor que se va a convertir.

ignoreCase
Boolean

true omitir mayúsculas y minúsculas; false en lo que respecta al caso.

Devoluciones

TEnum

TEnum Objeto de tipo TEnum cuyo valor está representado por value.

Excepciones

TEnum no es un tipo de Enum.

value no contiene información de enumeración.

.NET 8 y versiones posteriores: TEnum es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9

Parse<TEnum>(ReadOnlySpan<Char>)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte el intervalo de caracteres de representación del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente.

public static TEnum Parse<TEnum> (ReadOnlySpan<char> value) where TEnum : struct;

Parámetros de tipo

TEnum

Tipo de enumeración.

Parámetros

value
ReadOnlySpan<Char>

Intervalo que contiene el nombre o el valor que se va a convertir.

Devoluciones

TEnum

TEnum Objeto de tipo TEnum cuyo valor está representado por value.

Excepciones

TEnum no es un tipo de Enum.

value no contiene información de enumeración.

.NET 8 y versiones posteriores: TEnum es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9

Parse<TEnum>(String)

Source:
Enum.cs
Source:
Enum.cs
Source:
Enum.cs

Convierte la representación de cadena del nombre o valor numérico de una o varias constantes enumeradas especificadas por TEnum en un objeto enumerado equivalente.

public static TEnum Parse<TEnum> (string value) where TEnum : struct;

Parámetros de tipo

TEnum

Tipo de enumeración.

Parámetros

value
String

Cadena que contiene el nombre o el valor que se va a convertir.

Devoluciones

TEnum

Objeto de tipo TEnum cuyo valor se representa mediante value.

Excepciones

TEnum no es un tipo de Enum.

value es null.

value no contiene información de enumeración.

.NET 8 y versiones posteriores: TEnum es un tipo de enumeración con respaldo booleano.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1