OpCodes.Box Feld

  • Referenz

Definition

Namespace:
System.Reflection.Emit
Assembly:
System.Reflection.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
OpCodes.cs
Quelle:
OpCodes.cs
Quelle:
OpCodes.cs

Konvertiert einen Werttyp in einen Objektverweis (Typ 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

Feldwert

OpCode

Hinweise

In der folgenden Tabelle sind das Hexadezimal- und Microsoft MSIL-Assemblyformat (Intermediate Language) der Anweisung zusammen mit einer kurzen Referenzzusammenfassung aufgeführt:

Format Assemblyformat BESCHREIBUNG
8C <T> Box valTypeToken Konvertieren Sie einen Werttyp (des in angegebenen Typs) in valTypeTokeneinen true-Objektverweis.

Das Übergangsverhalten des Stapels in sequenzieller Reihenfolge lautet:

  1. Ein Werttyp wird auf den Stapel gepusht.

  2. Der Werttyp wird aus dem Stapel geknallt; Der box Vorgang wird ausgeführt.

  3. Ein Objektverweis auf den resultierenden Werttyp "boxed" wird auf den Stapel gepusht.

Ein Werttyp verfügt über zwei separate Darstellungen innerhalb der Common Language Infrastructure (CLI):

  • Ein unformatiertes Formular, das verwendet wird, wenn ein Werttyp in ein anderes Objekt oder im Stapel eingebettet ist.

  • Ein "boxed"-Formular, bei dem die Daten im Werttyp in ein Objekt umschlossen (geschachtelt) werden, sodass sie als unabhängige Entität vorhanden sein können.

Die box -Anweisung konvertiert den Werttyp "raw" (unboxed) in einen Objektverweis (Typ O). Dies wird erreicht, indem ein neues -Objekt erstellt und die Daten aus dem Werttyp in das neu zugeordnete Objekt kopiert werden. valTypeToken ist ein Metadatentoken, das den Typ des Werttyps im Stapel angibt.

OutOfMemoryException wird ausgelöst, wenn nicht genügend Arbeitsspeicher vorhanden ist, um die Anforderung zu erfüllen.

TypeLoadException wird ausgelöst, wenn die Klasse nicht gefunden werden kann. Dies wird in der Regel erkannt, wenn Microsoft Intermediate Language (MSIL) nicht zur Laufzeit, sondern in nativen Code konvertiert wird.

Die folgende Emit Methodenüberladung kann den box Opcode verwenden:

Gilt für: