OpCodes.Stelem Feld

Definition

Ersetzt das Arrayelement am angegebenen Index durch den Wert im Auswertungsstapel, dessen Typ in der Anweisung angegeben ist.Replaces the array element at a given index with the value on the evaluation stack, whose type is specified in the instruction.

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

Hinweise

In der folgenden Tabelle werden das hexadezimale und das MSIL-AssemblyFormat (Microsoft Intermediate Language) zusammen mit einer kurzen Verweis Zusammenfassung aufgelistet:The following table lists the instruction's hexadecimal and Microsoft intermediate language (MSIL) assembly format, along with a brief reference summary:

FormatFormat AssemblyFormatAssembly Format BeschreibungDescription
A4 < T >A4 < T > stelem-typeTokstelem typeTok Ersetzt das Array Element am angegebenen Index durch einen Wert vom Typ typeTok auf dem Stapel.Replaces the array element at the supplied index with a value of type typeTok on the stack.

Das Stapel Übergangs Verhalten ist in sequenzieller Reihenfolge:The stack transitional behavior, in sequential order, is:

  1. Ein Objekt Verweis auf ein Array, array, wird auf den Stapel verschoben.An object reference to an array, array, is pushed onto the stack.

  2. Ein Indexwert indexzu einem Element in array wird auf den Stapel verschoben.An index value, index, to an element in array is pushed onto the stack.

  3. Ein Wert des in der Anweisung angegebenen Typs wird auf den Stapel verschoben.A value of the type specified in the instruction is pushed onto the stack.

  4. Der Wert, der Index und der Array Verweis werden aus dem Stapel entfernt. der Wert wird in das Array Element am angegebenen Index eingefügt.The value, the index, and the array reference are popped from the stack; the value is put into the array element at the given index.

Die stelem Anweisung ersetzt den Wert des Elements am angegebenen Null basierten Index im eindimensionalen Array array mit dem Wert.The stelem instruction replaces the value of the element at the supplied zero-based index in the one-dimensional array array with the value. Der-Wert weist den Typ auf, der durch das Token typeTok in der Anweisung angegeben wird.The value has the type specified by the token typeTok in the instruction.

Arrays sind Objekte und werden daher durch einen Wert vom Typ Odargestellt.Arrays are objects, and hence represented by a value of type O. Der Index ist vom Typ native int.The index is type native int.

NullReferenceException wird ausgelöst, wenn array ein NULL-Verweis ist.NullReferenceException is thrown if array is a null reference.

IndexOutOfRangeException wird ausgelöst, wenn index negativ oder größer als die gebundene arrayist.IndexOutOfRangeException is thrown if index is negative, or larger than the bound of array.

ArrayTypeMismatchException wird ausgelöst, wenn array keine Elemente des erforderlichen Typs enthält.ArrayTypeMismatchException is thrown if array does not hold elements of the required type.

Die folgende Emit-Methoden Überladung kann den stelem Opcode verwenden:The following Emit method overload can use the stelem opcode:

Gilt für: