Compartilhar via


OpCodes.Stelem Campo

Definição

Substitui o elemento de matriz de um índice especificado 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

Comentários

A tabela a seguir lista o formato de assembly hexadecimal e msil da instrução, juntamente com um breve resumo de referência:

Formatar Formato de assembly Descrição
A4 <T> Stelem typeTok Substitui o elemento de matriz no índice fornecido por um valor do 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, index, para um elemento em array é 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 exibidos 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 é do tipo native int.

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

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

ArrayTypeMismatchException será gerado se array não armazenar elementos do tipo necessário.

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

Aplica-se a