Enum.ToObject 方法

定義

命名空間:

System

組件:

System.Runtime.dll

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

多載

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)

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

public:
 static System::Object ^ ToObject(Type ^ enumType, short value);

public static object ToObject (Type enumType, short value);

static member ToObject : Type * int16 -> obj

Public Shared Function ToObject (enumType As Type, value As Short) As Object

參數

enumType

Type

要傳回的列舉類型。

value

Int16

要轉換為列舉成員的值。

傳回

Object

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

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, Int32)

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

public:
 static System::Object ^ ToObject(Type ^ enumType, int value);

public static object ToObject (Type enumType, int value);

static member ToObject : Type * int -> obj

Public Shared Function ToObject (enumType As Type, value As Integer) As Object

參數

enumType

Type

要傳回的列舉類型。

value

Int32

要轉換為列舉成員的值。

傳回

Object

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

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, Int64)

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

public:
 static System::Object ^ ToObject(Type ^ enumType, long value);

public static object ToObject (Type enumType, long value);

static member ToObject : Type * int64 -> obj

Public Shared Function ToObject (enumType As Type, value As Long) As Object

參數

enumType

Type

要傳回的列舉類型。

value

Int64

要轉換為列舉成員的值。

傳回

Object

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

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, Object)

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::Object ^ value);

public static object ToObject (Type enumType, object value);

static member ToObject : Type * obj -> obj

Public Shared Function ToObject (enumType As Type, value As Object) As Object

參數

enumType

Type

要傳回的列舉類型。

value

Object

要轉換為列舉成員的值。

傳回

Object

值為 value 的列舉物件。

例外狀況

ArgumentNullException

enumType 或 value 為 null。

ArgumentException

enumType 不是 Enum。

-或-

value 不是類型 SByte、Int16、Int32、Int64、Byte、UInt16、UInt32 或 UInt64。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, SByte)

重要

此 API 不符合 CLS 規範。

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::SByte value);

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

[<System.CLSCompliant(false)>]
static member ToObject : Type * sbyte -> obj

Public Shared Function ToObject (enumType As Type, value As SByte) As Object

參數

enumType

Type

要傳回的列舉類型。

value

SByte

要轉換為列舉成員的值。

傳回

Object

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

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, UInt16)

重要

此 API 不符合 CLS 規範。

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::UInt16 value);

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

[<System.CLSCompliant(false)>]
static member ToObject : Type * uint16 -> obj

Public Shared Function ToObject (enumType As Type, value As UShort) As Object

參數

enumType

Type

要傳回的列舉類型。

value

UInt16

要轉換為列舉成員的值。

傳回

Object

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

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, UInt32)

重要

此 API 不符合 CLS 規範。

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::UInt32 value);

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

[<System.CLSCompliant(false)>]
static member ToObject : Type * uint32 -> obj

Public Shared Function ToObject (enumType As Type, value As UInteger) As Object

參數

enumType

Type

要傳回的列舉類型。

value

UInt32

要轉換為列舉成員的值。

傳回

Object

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

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, UInt64)

重要

此 API 不符合 CLS 規範。

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::UInt64 value);

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

[<System.CLSCompliant(false)>]
static member ToObject : Type * uint64 -> obj

Public Shared Function ToObject (enumType As Type, value As ULong) As Object

參數

enumType

Type

要傳回的列舉類型。

value

UInt64

要轉換為列舉成員的值。

傳回

Object

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

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)

ToObject(Type, Byte)

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

public:
 static System::Object ^ ToObject(Type ^ enumType, System::Byte value);

public static object ToObject (Type enumType, byte value);

static member ToObject : Type * byte -> obj

Public Shared Function ToObject (enumType As Type, value As Byte) As Object

參數

enumType

Type

要傳回的列舉類型。

value

Byte

要轉換為列舉成員的值。

傳回

Object

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

例外狀況

ArgumentNullException

enumType 為 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

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

備註

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

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

另請參閱

• IsDefined(Type, Object)