Enum.ToObject 方法

定義

將指定的整數值轉換為列舉成員。

多載

ToObject(Type, Int16)

將指定的 16 位元帶正負號的整數轉換為列舉成員。

ToObject(Type, Int32)

將指定的 32 位元帶正負號的整數轉換為列舉成員。

ToObject(Type, Int64)

將指定的 64 位元帶正負號的整數轉換為列舉成員。

ToObject(Type, Object)

將具有整數值的指定物件轉換為列舉成員。

ToObject(Type, SByte)

將指定的 8 位元帶正負號的整數值轉換為列舉成員。

ToObject(Type, UInt16)

將指定的 16 位元不帶正負號的整數值轉換為列舉成員。

ToObject(Type, UInt32)

將指定的 32 位元不帶正負號的整數值轉換為列舉成員。

ToObject(Type, UInt64)

將指定的 64 位元不帶正負號的整數值轉換為列舉成員。

ToObject(Type, Byte)

將指定的 8 位元不帶正負號的整數轉換為列舉成員。

ToObject(Type, Int16)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

將指定的 16 位元帶正負號的整數轉換為列舉成員。

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

參數

enumType
Type

要傳回的列舉類型。

value
Int16

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, Int16)value 轉換成其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, Int32)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

將指定的 32 位元帶正負號的整數轉換為列舉成員。

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

參數

enumType
Type

要傳回的列舉類型。

value
Int32

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, Int32)value 轉換成其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, Int64)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

將指定的 64 位元帶正負號的整數轉換為列舉成員。

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

參數

enumType
Type

要傳回的列舉類型。

value
Int64

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, Int64)value 轉換成其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, Object)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

將具有整數值的指定物件轉換為列舉成員。

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

參數

enumType
Type

要傳回的列舉類型。

value
Object

要轉換為列舉成員的值。

傳回

值為 value 的列舉物件。

屬性

例外狀況

enumTypevaluenull

enumType 不是 Enum

-或-

value 不是類型 SByteInt16Int32Int64ByteUInt16UInt32UInt64

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, Object) 會將整數值 value 轉換為其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.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

ToObject(Type, SByte)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

重要

此 API 不符合 CLS 規範。

將指定的 8 位元帶正負號的整數值轉換為列舉成員。

[System.CLSCompliant(false)]
public static object ToObject (Type enumType, sbyte value);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject (Type enumType, sbyte value);

參數

enumType
Type

要傳回的列舉類型。

value
SByte

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, SByte)value 轉換成其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, UInt16)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

重要

此 API 不符合 CLS 規範。

將指定的 16 位元不帶正負號的整數值轉換為列舉成員。

[System.CLSCompliant(false)]
public static object ToObject (Type enumType, ushort value);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject (Type enumType, ushort value);

參數

enumType
Type

要傳回的列舉類型。

value
UInt16

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, UInt16)value 轉換成其基礎值為 value 的列舉成員。 請注意,即使 value 超出成員界限 enumType ,轉換仍會成功。 若要確保 value 為列舉的有效基礎值 enumType ,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 型別 Object 的值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, UInt32)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

重要

此 API 不符合 CLS 規範。

將指定的 32 位元不帶正負號的整數值轉換為列舉成員。

[System.CLSCompliant(false)]
public static object ToObject (Type enumType, uint value);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject (Type enumType, uint value);

參數

enumType
Type

要傳回的列舉類型。

value
UInt32

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, UInt32)value 轉換成基礎值為 value 的列舉成員。 請注意,即使值超出成員界限 enumType ,轉換仍會成功。 若要確保 value 是列舉的有效 enumType 基礎值,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 類型的 Object 值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, UInt64)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

重要

此 API 不符合 CLS 規範。

將指定的 64 位元不帶正負號的整數值轉換為列舉成員。

[System.CLSCompliant(false)]
public static object ToObject (Type enumType, ulong value);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject (Type enumType, ulong value);

參數

enumType
Type

要傳回的列舉類型。

value
UInt64

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, UInt64)value 轉換成基礎值為 value 的列舉成員。 請注意,即使值超出成員界限 enumType ,轉換仍會成功。 若要確保 value 是列舉的有效 enumType 基礎值,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 類型的 Object 值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1

ToObject(Type, Byte)

來源:
Enum.cs
來源:
Enum.cs
來源:
Enum.cs

將指定的 8 位元不帶正負號的整數轉換為列舉成員。

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

參數

enumType
Type

要傳回的列舉類型。

value
Byte

要轉換為列舉成員的值。

傳回

設定為 value 的列舉執行個體。

屬性

例外狀況

enumTypenull

enumType 不是 Enum

.NET 8 和更新版本: enumType 是布林值支援的列舉類型。

備註

方法 ToObject(Type, Byte)value 轉換成基礎值為 value 的列舉成員。 請注意,即使值超出成員界限 enumType ,轉換仍會成功。 若要確保 value 是列舉的有效 enumType 基礎值,請將它傳遞至 IsDefined 方法。

這個轉換方法會傳回 類型的 Object 值。 然後,您可以轉換它,或將它轉換成 類型 enumType 的物件。

另請參閱

適用於

.NET 9 及其他版本
產品 版本
.NET 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 2.0, 2.1