OpCodes.Box Bidang

Definisi

Ruang nama:

System.Reflection.Emit

Rakitan:

System.Reflection.Primitives.dll

Sumber:

OpCodes.cs

Mengonversi jenis nilai menjadi referensi objek (jenis O).

public: static initonly System::Reflection::Emit::OpCode Box;

public static readonly System.Reflection.Emit.OpCode Box;

 staticval mutable Box : System.Reflection.Emit.OpCode

Public Shared ReadOnly Box As OpCode 

Nilai Bidang

OpCode

Keterangan

Tabel berikut mencantumkan format rakitan heksadesimal instruksi dan Microsoft Intermediate Language (MSIL), bersama dengan ringkasan referensi singkat:

Format	Format Rakitan	Deskripsi
8C <T>	Kotak valTypeToken	Mengonversi jenis nilai (dari jenis yang ditentukan dalam valTypeToken) menjadi referensi objek yang benar.

Perilaku transisi tumpukan, dalam urutan berurutan, adalah:

1. Jenis nilai didorong ke tumpukan.

2. Jenis nilai dimunculkan dari tumpukan; box operasi dilakukan.

3. Referensi objek ke jenis nilai "kotak" yang dihasilkan didorong ke tumpukan.

Jenis nilai memiliki dua representasi terpisah dalam Common Language Infrastructure (CLI):

• Formulir 'mentah' yang digunakan ketika jenis nilai disematkan dalam objek lain atau pada tumpukan.

• Formulir 'kotak', di mana data dalam jenis nilai dibungkus (dikotak) ke dalam objek sehingga dapat ada sebagai entitas independen.

box Instruksi mengonversi jenis nilai 'mentah' (tidak dikotak) menjadi referensi objek (jenis O). Ini dicapai dengan membuat objek baru dan menyalin data dari jenis nilai ke dalam objek yang baru dialokasikan. valTypeToken adalah token metadata yang menunjukkan jenis nilai pada tumpukan.

OutOfMemoryException dilemparkan jika tidak ada cukup memori untuk memenuhi permintaan.

TypeLoadException dilemparkan jika kelas tidak dapat ditemukan. Ini biasanya terdeteksi ketika Microsoft Intermediate Language (MSIL) dikonversi ke kode asli, bukan pada runtime.

Metode berikut Emit kelebihan beban dapat menggunakan box opcode:

• ILGenerator.Emit(OpCode, Type)