語言

Unsafe.Unbox<T>(Object) 方法

定義

將 a mutable ref 回傳為框值。

public:
generic <typename T>
 where T : value class static T % Unbox(System::Object ^ box);
public static ref T Unbox<T>(object box) where T : struct;
static member Unbox : obj -> 'T (requires 'T : struct)
Public Shared Function Unbox(Of T As Structure) (box As Object) As T

類型參數

T

那種要拆箱的類型。

參數

box
Object

開箱的價值。

傳回

T

A mutable ref 的框值 box。

例外狀況

box 是 null,且 T 是一個不可空的值型態。

box 不是框框值型態。

-或-

box 不是被框住 T的。

T 找不到。

備註

這個 Unbox<T> 方法其實就是 IL 開箱 指令的包裝器。 它作為效能優化很有用。 每當一個接受 的 Object API 需要以不同值型別的值重複呼叫時,可以重複使用同一個盒子物件,而不必每次都建立新的。

此 Unbox<T> 方法有一個重要的使用限制,語言編譯器不會強制執行,這是呼叫者的責任。 IL unbox 指令回傳一個受控可變性管理指標。 由於.NET與.NET語言編譯器無法表示此限制,Unbox<T> 方法回傳一個正常可變的 ref T。 然而,開發者 不得 對回傳的參考進行變異,除非他們確定該 T 引用是可變的結構型態。 例如,由於數值原語如 非 Int32 可變結構型別,以下程式碼不被支援:

// The following line is NOT SUPPORTED.
Unsafe.Unbox<int>(obj) = 30;

相較之下,像 這樣的 Point 型別是具有 public property setter 的可變結構體,因此支援透過呼叫屬性 setter 來變異盒中值:

// The following lines are legal and supported.
Unsafe.Unbox<System.Drawing.Point>(obj).X = 50;
Unsafe.Unbox<System.Drawing.Point>(obj).Y = 70;

然而,即使參考是可變結構型別,也不支援整套替換整個參考。

// Resetting the reference to default(T) is NOT SUPPORTED.
Unsafe.Unbox<System.Drawing.Point>(obj) = default(System.Drawing.Point);

// Setting the reference to a completely new value is NOT SUPPORTED.
Unsafe.Unbox<System.Drawing.Point>(obj) = new System.Drawing.Point(50, 70);

欲了解更多資訊,包括對此指令使用限制的詳細討論,請參閱 ECMA-335:通用語言基礎設施(CLI)中的第 III.1.8.1.2.2 節(「受控可變性管理指標」)及 III.4.32(「開箱——將框中值型別轉換為原始形式」)。

適用於