OpCodes.Stelem Feld

Definition

Namespace:
System.Reflection.Emit
Assemblys:
mscorlib.dll, System.Reflection.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
System.Reflection.Primitives.dll
Assembly:
netstandard.dll

Ersetzt das Arrayelement in einem bestimmten Index durch den Wert im Auswertungsstapel, dessen Typ in der Anweisung angegeben ist.

public: static initonly System::Reflection::Emit::OpCode Stelem;
public static readonly System.Reflection.Emit.OpCode Stelem;
 staticval mutable Stelem : System.Reflection.Emit.OpCode
Public Shared ReadOnly Stelem As OpCode

Feldwert

OpCode

Hinweise

Die folgende Tabelle enthält das Hexadezimal- und Microsoft MSIL-Assemblyformat (Intermediate Language) der Anweisung sowie eine kurze Referenzzusammenfassung:

Format Assemblyformat Description
A4 <T> Stelem typeTok Ersetzt das Arrayelement am angegebenen Index durch einen Typwert typeTok im Stapel.

Das Übergangsverhalten des Stapels in sequenzieller Reihenfolge lautet:

  1. Ein Objektverweis auf ein Array wird arrayauf den Stapel verschoben.

  2. Ein Indexwert , indexan ein Element in array wird auf den Stapel verschoben.

  3. Ein Wert des typs, der in der Anweisung angegeben ist, wird auf den Stapel verschoben.

  4. Der Wert, der Index und der Arrayverweis werden aus dem Stapel angezeigt; der Wert wird in das Arrayelement im angegebenen Index eingefügt.

Die stelem Anweisung ersetzt den Wert des Elements am bereitgestellten nullbasierten Index im eindimensionalen Array array durch den Wert. Der Wert weist den Typ auf, der durch das Token typeTok in der Anweisung angegeben wird.

Arrays sind Objekte und werden daher durch einen Wert vom Typ Odargestellt. Der Index ist typ native int.

NullReferenceException wird ausgelöst, wenn array es sich um einen Nullverweis handelt.

IndexOutOfRangeException wird ausgelöst, wenn index es negativ ist oder größer als die Grenze von array.

ArrayTypeMismatchException wird ausgelöst, wenn array keine Elemente des erforderlichen Typs enthalten sind.

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

Gilt für: