Unsafe.Unbox<T>(Object) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將 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
開箱的價值。
傳回
A mutable ref 的框值 box。
例外狀況
box 是 null,且 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(「開箱——將框中值型別轉換為原始形式」)。