OpCodes.Stelem_Ref 字段

定义

命名空间:
System.Reflection.Emit
程序集:
mscorlib.dll, System.Reflection.Primitives.dll
程序集:
mscorlib.dll
程序集:
System.Reflection.Primitives.dll
程序集:
netstandard.dll

将给定索引处的数组元素替换为计算堆栈上的对象 ref 值（类型 O）。

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

字段值

OpCode

注解

下表列出了指令的十六进制和Microsoft中间语言（MSIL）程序集格式，以及简短的参考摘要：

Format 程序集格式 说明
A2 stelem.ref 将提供的索引处的数组元素替换为 ref 堆栈上的值（类型 O）。

堆栈过渡行为按顺序排列，为：

  1. 对数组 array的对象引用被推送到堆栈上。

  2. 将有效索引推送到堆栈中 array 元素。

  3. 值被推送到堆栈上。

  4. 从堆栈中弹出值、索引和数组引用;该值将放入给定索引处的数组元素中。

该 stelem.ref 指令将一维数组 arrayref 中提供的索引处的元素值替换为推送到堆栈上的 （type O） 值。

数组是对象，因此由类型的 O值表示。 索引为类型 native int。

请注意， stelem.ref 在将值分配给数组元素之前，隐式将所提供的值强制转换为元素类型 array 。 即使对于已验证的代码，此强制转换也可能会失败。 因此，指令 stelem.ref 可以引发 InvalidCastException。 对于不是从零开始的数组和多维数组的一维数组，该 Array 类提供一种方法 SetValue 。

NullReferenceException 如果 array 为 null 引用，则引发 。

IndexOutOfRangeException 如果 index 为负数或大于其边界 array，则引发 。

如果未 保存所需类型的元素，将引发

以下 Emit 方法重载可以使用 stelem.ref 操作码：

适用于