Enum.Parse Methode

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

Parameter

Gibt zurück

Ein Objekt vom Typ enumType , dessen Wert durch valuedargestellt wird.

Attribute

ComVisibleAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird die Parse(Type, String) Methode verwendet, um ein Array von Zeichenfolgen zu analysieren, die durch Aufrufen der GetNames Methode erstellt werden. Außerdem wird die Parse(Type, String) Methode verwendet, um einen Enumerationswert zu analysieren, der aus einem Bitfeld besteht.

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
'

Hinweise

Der value Parameter enthält die Zeichenfolgendarstellung des zugrunde liegenden Werts oder der benannten Konstante eines Enumerationselements oder eine Liste benannter Konstanten, die durch Kommas (,) getrennt sind. Mindestens ein Leerzeichen kann jedem Wert, Namen oder Komma vorangestellt oder folgen value. Wenn value es sich um eine Liste handelt, ist der Rückgabewert der Wert der angegebenen Namen in Kombination mit einem bitweisen OR Vorgang.

Wenn value es sich um einen Namen handelt, der keiner benannten Konstante enumTypeentspricht, löst die Methode eine ArgumentException. Wenn value es sich um die Zeichenfolgendarstellung einer ganzen Zahl handelt, die keinen zugrunde liegenden Wert der enumType Enumeration darstellt, gibt die Methode ein Enumerationselement zurück, dessen zugrunde liegender Wert in einen integralen Typ konvertiert wird value . Wenn dieses Verhalten nicht erwünscht ist, rufen Sie die IsDefined Methode auf, um sicherzustellen, dass eine bestimmte Zeichenfolgendarstellung einer ganzen Zahl tatsächlich ein Element von enumTypeist. Im folgenden Beispiel wird eine Colors Enumeration definiert, die Parse(Type, String) Methode aufgerufen, um Zeichenfolgen in die entsprechenden Enumerationswerte zu konvertieren, und die IsDefined Methode wird aufgerufen, um sicherzustellen, dass bestimmte integrale Werte zugrunde liegende Werte in der Colors Enumeration sind.

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.

Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Weitere Informationen

• IsDefined(Type, Object)

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

Parameter

Gibt zurück

Ein Objekt vom Typ enumType , dessen Wert durch valuedargestellt wird.

Attribute

ComVisibleAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird die Parse(Type, String, Boolean) Methode verwendet, um ein Array von Zeichenfolgen zu analysieren, die durch Aufrufen der GetNames Methode erstellt werden. Außerdem wird die Parse(Type, String) Methode verwendet, um einen Enumerationswert zu analysieren, der aus einem Bitfeld besteht.

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.

Hinweise

Der value Parameter enthält die Zeichenfolgendarstellung des zugrunde liegenden Werts oder der benannten Konstante eines Enumerationselements oder eine Liste benannter Konstanten, die durch Kommas (,) getrennt sind. Mindestens ein Leerzeichen kann jedem Wert, Namen oder Komma vorangestellt oder folgen value. Wenn value es sich um eine Liste handelt, ist der Rückgabewert der Wert der angegebenen Namen in Kombination mit einem bitweisen OR Vorgang.

Wenn value es sich um einen Namen handelt, der keiner benannten Konstante enumTypeentspricht, löst die Methode eine ArgumentException. Wenn value es sich um die Zeichenfolgendarstellung einer ganzen Zahl handelt, die keinen zugrunde liegenden Wert der enumType Enumeration darstellt, gibt die Methode ein Enumerationselement zurück, dessen zugrunde liegender Wert in einen integralen Typ konvertiert wird value . Wenn dieses Verhalten nicht erwünscht ist, rufen Sie die IsDefined Methode auf, um sicherzustellen, dass eine bestimmte Zeichenfolgendarstellung einer ganzen Zahl tatsächlich ein Element von enumTypeist. Im folgenden Beispiel wird eine Colors Enumeration definiert, die Parse(Type, String, Boolean) Methode aufgerufen, um Zeichenfolgen in die entsprechenden Enumerationswerte zu konvertieren, und die IsDefined Methode wird aufgerufen, um sicherzustellen, dass bestimmte integrale Werte zugrunde liegende Werte in der Colors Enumeration sind.

Der ignoreCase Parameter gibt an, ob bei diesem Vorgang die Groß-/Kleinschreibung beachtet wird.

Weitere Informationen

• IsDefined(Type, Object)

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

Typparameter

Parameter

Gibt zurück

Ein Objekt vom Typ TEnum , dessen Wert durch valuedargestellt wird.

Ausnahmen

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

Typparameter

Parameter

Gibt zurück

Ein Objekt vom Typ TEnum , dessen Wert durch valuedargestellt wird.

Ausnahmen