OpCodes.Stelem Campo

Definição

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

Substitui o elemento de matriz em um determinado índice pelo valor na pilha de avaliação, cujo tipo é especificado na instrução.

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

Valor do campo

OpCode

Comentários

A tabela a seguir lista o formato de assembly hexadecimal e Microsoft idioma intermediário (MSIL) da instrução, juntamente com um breve resumo de referência:

Formato Formato de assembly Description
A4 <T> Stelem typeTok Substitui o elemento de matriz no índice fornecido por um valor de tipo typeTok na pilha.

O comportamento de transição da pilha, em ordem sequencial, é:

  1. Uma referência de objeto a uma matriz arrayé enviada por push para a pilha.

  2. Um valor de índice, indexpara um elemento no array qual é enviado por push para a pilha.

  3. Um valor do tipo especificado na instrução é enviado por push para a pilha.

  4. O valor, o índice e a referência da matriz são extraídos da pilha; o valor é colocado no elemento de matriz no índice fornecido.

A stelem instrução substitui o valor do elemento no índice baseado em zero fornecido na matriz array unidimensional pelo valor. O valor tem o tipo especificado pelo token typeTok na instrução.

Matrizes são objetos e, portanto, representadas por um valor do tipo O. O índice é tipo native int.

NullReferenceException será gerado se array for uma referência nula.

IndexOutOfRangeException é gerado se index for negativo ou maior que o limite de array.

ArrayTypeMismatchException é gerado se array não contém elementos do tipo necessário.

A sobrecarga do método Emit a seguir pode usar o stelem opcode:

Aplica-se a