Enum.ToObject 方法

定義

命名空間:: System

組件:: mscorlib.dll

組件:: netstandard.dll

組件:: mscorlib.dll, System.Runtime.dll

組件:: System.Runtime.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
ToObject(Type, Int16)	將指定的16位帶正負號整數轉換為列舉成員。
ToObject(Type, UInt64)	將指定的 64 位無符號整數值轉換為列舉成員。
ToObject(Type, UInt32)	將指定的32位無符號整數值轉換為列舉成員。
ToObject(Type, UInt16)	將指定的16位無符號整數值轉換為列舉成員。
ToObject(Type, SByte)	將指定的8位帶正負號整數值轉換為列舉成員。
ToObject(Type, Object)	將具有整數值的指定物件轉換為列舉成員。
ToObject(Type, Int64)	將指定的64位帶正負號整數轉換為列舉成員。
ToObject(Type, Int32)	將指定的32位帶正負號整數轉換為列舉成員。
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);

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

static member ToObject : Type * int16 -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member ToObject : Type * int16 -> obj

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

參數

enumType: Type

回傳的列舉類型。

value: Int16

轉換為枚舉成員的價值。

傳回

Object

一個列舉的實例，設為 value。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, Int16) 方法會 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)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject(Type enumType, ulong value);

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
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 ComVisibleAttribute

例外狀況

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, 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)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject(Type enumType, uint value);

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
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 ComVisibleAttribute

例外狀況

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, 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)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject(Type enumType, ushort value);

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
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 ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, UInt16) 方法會 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)]
[System.Runtime.InteropServices.ComVisible(true)]
public static object ToObject(Type enumType, sbyte value);

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
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 ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, SByte) 方法會 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);

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

static member ToObject : Type * obj -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member ToObject : Type * obj -> obj

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

參數

enumType: Type

回傳的列舉類型。

value: Object

該值轉換為枚舉成員。

傳回

Object

一個枚舉物件，其值為 value。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 或 value 為 null。

ArgumentException

enumType 不是 Enum。

-或者-

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

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, Object) 方法將整數值 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);

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

static member ToObject : Type * int64 -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member ToObject : Type * int64 -> obj

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

參數

enumType: Type

回傳的列舉類型。

value: Int64

轉換為枚舉成員的價值。

傳回

Object

一個列舉的實例，設為 value。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, Int64) 方法會 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);

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

static member ToObject : Type * int -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member ToObject : Type * int -> obj

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

參數

enumType: Type

回傳的列舉類型。

value: Int32

轉換為枚舉成員的價值。

傳回

Object

一個列舉的實例，設為 value。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, Int32) 方法會 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);

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

static member ToObject : Type * byte -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member ToObject : Type * byte -> obj

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

參數

enumType: Type

回傳的列舉類型。

value: Byte

轉換為枚舉成員的價值。

傳回

Object

一個列舉的實例，設為 value。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

enumType 是 null。

ArgumentException

enumType 不是 Enum。

InvalidOperationException

.NET 8 及以後版本：enumType 是一種布林背列舉類型。

備註

該 ToObject(Type, Byte) 方法會 value 轉換成一個枚舉成員，其底層值為 value。請注意，即使價值超出成員範圍 enumType ，轉換仍會成功。為確保該 value 枚舉的有效底層值 enumType ，將該值傳給 IsDefined 方法。

此轉換方法回傳的值為 Object。接著你可以施放或轉換成的物件 enumType類型。

另請參閱

IsDefined(Type, Object)

適用於

意見反應

此頁面對您有幫助嗎？