英語で読む

次の方法で共有


Enum.Parse メソッド

定義

1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。

オーバーロード

Parse(Type, ReadOnlySpan<Char>)

1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。

Parse(Type, String)

1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。

Parse(Type, ReadOnlySpan<Char>, Boolean)

1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

Parse(Type, String, Boolean)

1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

Parse<TEnum>(String, Boolean)

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

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

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

Parse<TEnum>(ReadOnlySpan<Char>)

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。

Parse<TEnum>(String)

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。

Parse(Type, ReadOnlySpan<Char>)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。

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

パラメーター

enumType
Type

列挙型。

value
ReadOnlySpan<Char>

変換する名前または値を含むスパン。

戻り値

valueで表される値を持つ enumType 型のオブジェクト。

例外

enumTypenullです。

enumTypeEnumではありません。

value は空の文字列であるか、空白のみを含みます。

value は名前ですが、列挙型に定義されている名前付き定数の 1 つではありません。

value は、基になる型の enumTypeの範囲外です。

.NET 8 以降のバージョン: enumType はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

Parse(Type, String)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。

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

パラメーター

enumType
Type

列挙型。

value
String

変換する名前または値を含む文字列。

戻り値

valueで表される値を持つ enumType 型のオブジェクト。

属性

例外

enumType または valuenull

enumTypeEnumではありません。

-又は-

value は空の文字列であるか、空白のみを含みます。

-又は-

value は名前ですが、列挙型に定義されている名前付き定数の 1 つではありません。

value は、基になる型の enumTypeの範囲外です。

.NET 8 以降のバージョン: enumType はブール値に基づく列挙型です。

次の例では、Parse(Type, String) メソッドを使用して、GetNames メソッドを呼び出して作成された文字列の配列を解析します。 また、Parse(Type, String) メソッドを使用して、ビット フィールドで構成される列挙値を解析します。

C#
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

*/

注釈

value パラメーターには、列挙メンバーの基になる値または名前付き定数の文字列表現、またはコンマ (,) で区切られた名前付き定数のリストが含まれます。 valueの各値、名前、またはコンマの前または後に 1 つ以上の空白を指定できます。 value がリストの場合、戻り値は、ビットごとの OR 演算と組み合わせた指定された名前の値です。

valueenumTypeの名前付き定数に対応しない名前の場合、メソッドは ArgumentExceptionをスローします。 value が、enumType 列挙体の基になる値を表さない整数の文字列表現である場合、メソッドは、基になる値が整数型に変換 value 列挙メンバーを返します。 この動作が望ましくない場合は、IsDefined メソッドを呼び出して、整数の特定の文字列表現が実際に enumTypeのメンバーであることを確認します。 次の例では、Colors 列挙型を定義し、Parse(Type, String) メソッドを呼び出して文字列を対応する列挙値に変換し、IsDefined メソッドを呼び出して、特定の整数値が Colors 列挙型の基になる値であることを確認します。

C#
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.

この操作では、大文字と小文字が区別されます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.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)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

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

パラメーター

enumType
Type

列挙型。

value
ReadOnlySpan<Char>

変換する名前または値を含むスパン。

ignoreCase
Boolean

大文字と小文字を区別しない true。ケースに関する false

戻り値

valueで表される値を持つ enumType 型のオブジェクト。

例外

enumTypenullです。

enumTypeEnumではありません。

value は空の文字列であるか、空白のみを含みます。

value は名前ですが、列挙型に定義されている名前付き定数の 1 つではありません。

value が基になる型の enumType の範囲外です

.NET 8 以降のバージョン: enumType はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

Parse(Type, String, Boolean)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

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

パラメーター

enumType
Type

列挙型。

value
String

変換する名前または値を含む文字列。

ignoreCase
Boolean

大文字と小文字を区別しない true。ケースに関する false

戻り値

valueで表される値を持つ enumType 型のオブジェクト。

属性

例外

enumType または valuenull

enumTypeEnumではありません。

-又は-

value は空の文字列 ("") であるか、空白のみを含みます。

-又は-

value は名前ですが、列挙型に定義されている名前付き定数の 1 つではありません。

value は、基になる型の enumTypeの範囲外です。

.NET 8 以降のバージョン: enumType はブール値に基づく列挙型です。

次の例では、Parse(Type, String, Boolean) メソッドを使用して、GetNames メソッドを呼び出して作成された文字列の配列を解析します。 また、Parse(Type, String) メソッドを使用して、ビット フィールドで構成される列挙値を解析します。

C#
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.

注釈

value パラメーターには、列挙メンバーの基になる値または名前付き定数の文字列表現、またはコンマ (,) で区切られた名前付き定数のリストが含まれます。 valueの各値、名前、またはコンマの前または後に 1 つ以上の空白を指定できます。 value がリストの場合、戻り値は、ビットごとの OR 演算と組み合わせた指定された名前の値です。

valueenumTypeの名前付き定数に対応しない名前の場合、メソッドは ArgumentExceptionをスローします。 value が、enumType 列挙体の基になる値を表さない整数の文字列表現である場合、メソッドは、基になる値が整数型に変換 value 列挙メンバーを返します。 この動作が望ましくない場合は、IsDefined メソッドを呼び出して、整数の特定の文字列表現が実際に enumTypeのメンバーであることを確認します。 次の例では、Colors 列挙型を定義し、Parse(Type, String, Boolean) メソッドを呼び出して文字列を対応する列挙値に変換し、IsDefined メソッドを呼び出して、特定の整数値が Colors 列挙型の基になる値であることを確認します。

ignoreCase パラメーターは、この操作で大文字と小文字が区別されるかどうかを指定します。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.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)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

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

型パラメーター

TEnum

列挙型。

パラメーター

value
String

変換する名前または値を含む文字列。

ignoreCase
Boolean

大文字と小文字を区別しない true。ケースに関する false

戻り値

TEnum

valueで表される値を持つ TEnum 型のオブジェクト。

例外

TEnumEnum 型ではありません。

valuenullです。

value には列挙情報が含まれていません。

.NET 8 以降のバージョン: TEnum はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.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)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。 パラメーターは、操作で大文字と小文字が区別されないかどうかを指定します。

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

型パラメーター

TEnum

列挙型。

パラメーター

value
ReadOnlySpan<Char>

変換する名前または値を含むスパン。

ignoreCase
Boolean

大文字と小文字を区別しない true。ケースに関する false

戻り値

TEnum

TEnum valueで表される値を持つ TEnum 型のオブジェクトです。

例外

TEnumEnum 型ではありません。

value には列挙情報が含まれていません。

.NET 8 以降のバージョン: TEnum はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

Parse<TEnum>(ReadOnlySpan<Char>)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字表現のスパンを等価の列挙オブジェクトに変換します。

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

型パラメーター

TEnum

列挙型。

パラメーター

value
ReadOnlySpan<Char>

変換する名前または値を含むスパン。

戻り値

TEnum

TEnum valueで表される値を持つ TEnum 型のオブジェクトです。

例外

TEnumEnum 型ではありません。

value には列挙情報が含まれていません。

.NET 8 以降のバージョン: TEnum はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

Parse<TEnum>(String)

ソース:
Enum.cs
ソース:
Enum.cs
ソース:
Enum.cs

TEnum で指定された 1 つ以上の列挙定数の名前または数値の文字列形式を等価の列挙オブジェクトに変換します。

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

型パラメーター

TEnum

列挙型。

パラメーター

value
String

変換する名前または値を含む文字列。

戻り値

TEnum

valueで表される値を持つ TEnum 型のオブジェクト。

例外

TEnumEnum 型ではありません。

valuenullです。

value には列挙情報が含まれていません。

.NET 8 以降のバージョン: TEnum はブール値に基づく列挙型です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.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