Enum.Parse Méthode

Définition

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d'une ou de plusieurs constantes énumérées en objet énuméré équivalent.

Surcharges

Parse(Type, ReadOnlySpan<Char>)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou plusieurs constantes énumérées en objet énuméré équivalent.

Parse(Type, String)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d'une ou de plusieurs constantes énumérées en objet énuméré équivalent.

Parse(Type, ReadOnlySpan<Char>, Boolean)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou plusieurs constantes énumérées en objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

Parse(Type, String, Boolean)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d'une ou de plusieurs constantes énumérées en objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

Parse<TEnum>(String, Boolean)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d’une ou plusieurs constantes énumérées spécifiées par TEnumen un objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

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

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou de plusieurs constantes énumérées spécifiées par TEnum en un objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

Parse<TEnum>(ReadOnlySpan<Char>)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou de plusieurs constantes énumérées spécifiées par TEnum en un objet énuméré équivalent.

Parse<TEnum>(String)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d’une ou plusieurs constantes énumérées spécifiées par TEnumen un objet énuméré équivalent.

Parse(Type, ReadOnlySpan<Char>)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou plusieurs constantes énumérées en objet énuméré équivalent.

public:
 static System::Object ^ Parse(Type ^ enumType, ReadOnlySpan<char> value);
public static object Parse (Type enumType, ReadOnlySpan<char> value);
static member Parse : Type * ReadOnlySpan<char> -> obj
Public Shared Function Parse (enumType As Type, value As ReadOnlySpan(Of Char)) As Object

Paramètres

enumType
Type

Type énumération.

value
ReadOnlySpan<Char>

Étendue contenant le nom ou la valeur à convertir.

Retours

Objet de type enumType dont la valeur est représentée par value.

Exceptions

enumType a la valeur null.

enumType n'est pas Enum.

value est une chaîne vide ou contient uniquement des espaces blancs.

value est un nom, mais celui-ci ne fait pas partie des constantes nommées définies pour l’énumération.

value est en dehors de la plage du type sous-jacent enumType.

.NET 8 et versions ultérieures : enumType est un type d’énumération booléen.

S’applique à

Parse(Type, String)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d'une ou de plusieurs constantes énumérées en objet énuméré équivalent.

public:
 static System::Object ^ Parse(Type ^ enumType, System::String ^ value);
public static object Parse (Type enumType, string value);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Parse (Type enumType, string value);
static member Parse : Type * string -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Parse : Type * string -> obj
Public Shared Function Parse (enumType As Type, value As String) As Object

Paramètres

enumType
Type

Type énumération.

value
String

Chaîne contenant le nom ou la valeur à convertir.

Retours

Objet de type enumType dont la valeur est représentée par value.

Attributs

Exceptions

enumType ou value est null.

enumType n'est pas Enum.

- ou -

value est une chaîne vide ou contient uniquement des espaces blancs.

- ou -

value est un nom, mais celui-ci ne fait pas partie des constantes nommées définies pour l’énumération.

value est en dehors de la plage du type sous-jacent enumType.

.NET 8 et versions ultérieures : enumType est un type d’énumération booléen.

Exemples

L’exemple suivant utilise la Parse(Type, String) méthode pour analyser un tableau de chaînes créées en appelant la GetNames méthode . Il utilise également la Parse(Type, String) méthode pour analyser une valeur d’énumération qui se compose d’un champ de bits.

using namespace System;

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

int main()
{
   Console::WriteLine(  "The entries of the Colors enumeration are:" );
   Array^ a = Enum::GetNames( Colors::typeid );
   Int32 i = 0;
   while ( i < a->Length )
   {
      Object^ o = a->GetValue( i );
      Console::WriteLine( o->ToString() );
      i++;
   }

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

/*
This code example produces the following results:

The entries of the Colors Enum are:
Red
Green
Blue
Yellow

The orange value has the combined entries of Red, Yellow

*/
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

*/
open System

[<Flags>]
type Colors =
    | Red = 1
    | Green = 2
    | Blue = 4
    | Yellow = 8

printfn "The entries of the Colors enumeration are:"
for colorName in Enum.GetNames typeof<Colors> do
    printfn $"{colorName} = {Enum.Parse(typeof<Colors>, colorName):D}"
printfn ""

let orange = Enum.Parse(typeof<Colors>, "Red, Yellow") :?> Colors
printfn $"The orange value {orange:D} has the combined entries of {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
Public Class ParseTest

    <Flags()> _
    Enum Colors
        Red = 1
        Green = 2
        Blue = 4
        Yellow = 8
    End Enum

    Public Shared Sub Main()
        Console.WriteLine("The entries of the Colors enumeration are:")
        Dim colorName As String
        For Each colorName In [Enum].GetNames(GetType(Colors))
            Console.WriteLine("{0} = {1:D}", colorName, [Enum].Parse(GetType(Colors), colorName))
        Next
        Console.WriteLine()

        Dim orange As Colors = CType([Enum].Parse(GetType(Colors), "Red, Yellow"), Colors)
        Console.WriteLine("The orange value {0:D} has the combined entries of {0}", orange)
    End Sub
End Class

'This example displays the following output:
'
'The entries of the Colors Enum are:
'Red = 1
'Green = 2
'Blue = 4
'Yellow = 8
'
'The myOrange value 9 has the combined entries of Red, Yellow
'

Remarques

Le value paramètre contient la représentation sous forme de chaîne de la valeur sous-jacente ou de la constante nommée d’un membre d’énumération, ou une liste de constantes nommées délimitées par des virgules (,). Un ou plusieurs espaces vides peuvent précéder ou suivre chaque valeur, nom ou virgule dans value. Si value est une liste, la valeur de retour est la valeur des noms spécifiés combinée à une opération au niveau du OR bit.

Si value est un nom qui ne correspond pas à une constante nommée de enumType, la méthode lève un ArgumentException. Si value est la représentation sous forme de chaîne d’un entier qui ne représente pas une valeur sous-jacente de l’énumération enumType , la méthode retourne un membre d’énumération dont la valeur sous-jacente est value convertie en type intégral. Si ce comportement n’est pas souhaitable, appelez la IsDefined méthode pour vous assurer qu’une représentation sous forme de chaîne particulière d’un entier est en fait un membre de enumType. L’exemple suivant définit une Colors énumération, appelle la Parse(Type, String) méthode pour convertir des chaînes en leurs valeurs d’énumération correspondantes et appelle la IsDefined méthode pour s’assurer que des valeurs intégrales particulières sont des valeurs sous-jacentes dans l’énumération 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.
open System

[<Flags>]
type Colors =
    | None = 0
    | Red = 1
    | Green = 2
    | Blue = 4

let colorStrings = [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
    try
        let colorValue = Enum.Parse(typeof<Colors>, colorString) :?> Colors
        if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
            printfn $"Converted '{colorString}' to {colorValue}."
        else
            printfn $"{colorString} is not an underlying value of the Colors enumeration."
    with :? ArgumentException ->
        printfn $"'{colorString}' is not a member of the Colors enumeration."
// 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.
<Flags> Enum Colors As Integer
   None = 0
   Red = 1
   Green = 2
   Blue = 4
End Enum

Module Example
   Public Sub Main()
      Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
      For Each colorString As String In colorStrings
         Try
            Dim colorValue As Colors = CType([Enum].Parse(GetType(Colors), colorString), Colors)        
            If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then 
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
            Else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)            
            End If                    
         Catch e As ArgumentException
            Console.WriteLine("'{0}' is not a member of the Colors enumeration.", colorString)
         End Try
      Next
   End Sub
End Module
' 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.

Cette opération respecte la casse.

Voir aussi

S’applique à

Parse(Type, ReadOnlySpan<Char>, Boolean)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou plusieurs constantes énumérées en objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

public:
 static System::Object ^ Parse(Type ^ enumType, ReadOnlySpan<char> value, bool ignoreCase);
public static object Parse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase);
static member Parse : Type * ReadOnlySpan<char> * bool -> obj
Public Shared Function Parse (enumType As Type, value As ReadOnlySpan(Of Char), ignoreCase As Boolean) As Object

Paramètres

enumType
Type

Type énumération.

value
ReadOnlySpan<Char>

Étendue contenant le nom ou la valeur à convertir.

ignoreCase
Boolean

true pour ignorer la casse ; sinon, false.

Retours

Objet de type enumType dont la valeur est représentée par value.

Exceptions

enumType a la valeur null.

enumType n'est pas Enum.

value est une chaîne vide ou contient uniquement des espaces blancs.

value est un nom, mais celui-ci ne fait pas partie des constantes nommées définies pour l’énumération.

value est en dehors de la plage du type sous-jacent de enumType

.NET 8 et versions ultérieures : enumType est un type d’énumération booléen.

S’applique à

Parse(Type, String, Boolean)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d'une ou de plusieurs constantes énumérées en objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

public:
 static System::Object ^ Parse(Type ^ enumType, System::String ^ value, bool ignoreCase);
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);
static member Parse : Type * string * bool -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Parse : Type * string * bool -> obj
Public Shared Function Parse (enumType As Type, value As String, ignoreCase As Boolean) As Object

Paramètres

enumType
Type

Type énumération.

value
String

Chaîne contenant le nom ou la valeur à convertir.

ignoreCase
Boolean

true pour ignorer la casse ; sinon, false.

Retours

Objet de type enumType dont la valeur est représentée par value.

Attributs

Exceptions

enumType ou value est null.

enumType n'est pas Enum.

- ou -

value est une chaîne vide ("") ou contient uniquement des espaces blancs.

- ou -

value est un nom, mais celui-ci ne fait pas partie des constantes nommées définies pour l’énumération.

value est en dehors de la plage du type sous-jacent enumType.

.NET 8 et versions ultérieures : enumType est un type d’énumération booléen.

Exemples

L’exemple suivant utilise la Parse(Type, String, Boolean) méthode pour analyser un tableau de chaînes créées en appelant la GetNames méthode . Il utilise également la Parse(Type, String) méthode pour analyser une valeur d’énumération qui se compose d’un champ 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.
open System

[<Flags>]
type Colors =
    | None = 0
    | Red = 1
    | Green = 2
    | Blue = 4

let colorStrings = [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
    try
        let colorValue = Enum.Parse(typeof<Colors>, colorString, true) :?> Colors
        if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
            printfn $"Converted '{colorString}' to {colorValue}."
        else
            printfn $"{colorString} is not an underlying value of the Colors enumeration."
    with :? ArgumentException ->
        printfn $"{colorString} is not a member of the Colors enumeration."

// 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.
<Flags> Enum Colors As Integer
   None = 0
   Red = 1
   Green = 2
   Blue = 4
End Enum

Module Example
   Public Sub Main()
      Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
      For Each colorString As String In colorStrings
         Try
            Dim colorValue As Colors = CType([Enum].Parse(GetType(Colors), colorString, True), Colors)        
            If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then 
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
            Else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)            
            End If                    
         Catch e As ArgumentException
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
         End Try
      Next
   End Sub
End Module
' 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.

Remarques

Le value paramètre contient la représentation sous forme de chaîne de la valeur sous-jacente ou de la constante nommée d’un membre d’énumération, ou une liste de constantes nommées délimitées par des virgules (,). Un ou plusieurs espaces vides peuvent précéder ou suivre chaque valeur, nom ou virgule dans value. Si value est une liste, la valeur de retour est la valeur des noms spécifiés combinée à une opération au niveau du OR bit.

Si value est un nom qui ne correspond pas à une constante nommée de enumType, la méthode lève un ArgumentException. Si value est la représentation sous forme de chaîne d’un entier qui ne représente pas une valeur sous-jacente de l’énumération enumType , la méthode retourne un membre d’énumération dont la valeur sous-jacente est value convertie en type intégral. Si ce comportement n’est pas souhaitable, appelez la IsDefined méthode pour vous assurer qu’une représentation sous forme de chaîne particulière d’un entier est en fait un membre de enumType. L’exemple suivant définit une Colors énumération, appelle la Parse(Type, String, Boolean) méthode pour convertir des chaînes en leurs valeurs d’énumération correspondantes et appelle la IsDefined méthode pour s’assurer que des valeurs intégrales particulières sont des valeurs sous-jacentes dans l’énumération Colors .

Le ignoreCase paramètre spécifie si cette opération respecte la casse.

Voir aussi

S’applique à

Parse<TEnum>(String, Boolean)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d’une ou plusieurs constantes énumérées spécifiées par TEnumen un objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

public:
generic <typename TEnum>
 where TEnum : value class static TEnum Parse(System::String ^ value, bool ignoreCase);
public static TEnum Parse<TEnum> (string value, bool ignoreCase) where TEnum : struct;
static member Parse : string * bool -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As String, ignoreCase As Boolean) As TEnum

Paramètres de type

TEnum

Type énumération.

Paramètres

value
String

Chaîne contenant le nom ou la valeur à convertir.

ignoreCase
Boolean

true pour ignorer la casse ; sinon, false.

Retours

TEnum

Objet de type TEnum dont la valeur est représentée par value.

Exceptions

TEnum n’est pas un type Enum.

value a la valeur null.

value ne contient pas d’informations d’énumération.

.NET 8 et versions ultérieures : TEnum est un type d’énumération booléen.

S’applique à

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

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou de plusieurs constantes énumérées spécifiées par TEnum en un objet énuméré équivalent. Un paramètre spécifie si l'opération ne respecte pas la casse.

public:
generic <typename TEnum>
 where TEnum : value class static TEnum Parse(ReadOnlySpan<char> value, bool ignoreCase);
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase) where TEnum : struct;
static member Parse : ReadOnlySpan<char> * bool -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ignoreCase As Boolean) As TEnum

Paramètres de type

TEnum

Type énumération.

Paramètres

value
ReadOnlySpan<Char>

Étendue contenant le nom ou la valeur à convertir.

ignoreCase
Boolean

true pour ignorer la casse ; sinon, false.

Retours

TEnum

TEnum Objet de type TEnum dont la valeur est représentée par value.

Exceptions

TEnum n’est pas un type Enum.

value ne contient pas d’informations d’énumération.

.NET 8 et versions ultérieures : TEnum est un type d’énumération booléen.

S’applique à

Parse<TEnum>(ReadOnlySpan<Char>)

Convertit l’étendue de caractères représentant le nom ou la valeur numérique d’une ou de plusieurs constantes énumérées spécifiées par TEnum en un objet énuméré équivalent.

public:
generic <typename TEnum>
 where TEnum : value class static TEnum Parse(ReadOnlySpan<char> value);
public static TEnum Parse<TEnum> (ReadOnlySpan<char> value) where TEnum : struct;
static member Parse : ReadOnlySpan<char> -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char)) As TEnum

Paramètres de type

TEnum

Type énumération.

Paramètres

value
ReadOnlySpan<Char>

Étendue contenant le nom ou la valeur à convertir.

Retours

TEnum

TEnum Objet de type TEnum dont la valeur est représentée par value.

Exceptions

TEnum n’est pas un type Enum.

value ne contient pas d’informations d’énumération.

.NET 8 et versions ultérieures : TEnum est un type d’énumération booléen.

S’applique à

Parse<TEnum>(String)

Convertit la représentation sous forme de chaîne du nom ou de la valeur numérique d’une ou plusieurs constantes énumérées spécifiées par TEnumen un objet énuméré équivalent.

public:
generic <typename TEnum>
 where TEnum : value class static TEnum Parse(System::String ^ value);
public static TEnum Parse<TEnum> (string value) where TEnum : struct;
static member Parse : string -> 'Enum (requires 'Enum : struct)
Public Shared Function Parse(Of TEnum As Structure) (value As String) As TEnum

Paramètres de type

TEnum

Type énumération.

Paramètres

value
String

Chaîne contenant le nom ou la valeur à convertir.

Retours

TEnum

Objet de type TEnum dont la valeur est représentée par value.

Exceptions

TEnum n’est pas un type Enum.

value a la valeur null.

value ne contient pas d’informations d’énumération.

.NET 8 et versions ultérieures : TEnum est un type d’énumération booléen.

S’applique à