OpCodes.Stelem Campo

Definição

Namespace:

System.Reflection.Emit

Assemblies:

netstandard.dll, System.Reflection.Primitives.dll

Origem:

OpCodes.cs

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

OpCode

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:

• ILGenerator.Emit(OpCode, Type)