OpCodes.Ldelem_Ref Campo

  • Referência

Definição

Namespace:
System.Reflection.Emit
Assembly:
System.Reflection.Primitives.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
OpCodes.cs
Origem:
OpCodes.cs
Origem:
OpCodes.cs

Carrega o elemento que contém uma referência de objeto em um índice de matriz especificado para o topo da pilha de avaliação como tipo O (referência de objeto).

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

Valor do campo

OpCode

Comentários

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

Formatar Formato de assembly Descrição
9A ldelem.ref Carrega o elemento com uma referência de objeto em na index parte superior da pilha como o tipo O.

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

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

  2. Um valor index de índice é enviado por push para a pilha.

  3. index e array são exibidos da pilha; o valor armazenado na posição index em array é pesquisado.

  4. O valor é enviado por push para a pilha.

A ldelem.ref instrução carrega o valor do elemento com índice index (tipo native int) na matriz array unidimensional baseada em zero e o coloca na parte superior da pilha. Matrizes são objetos e, portanto, representadas por um valor do tipo O.

O valor retornado para ldelem.ref é o tipo O (referência de objeto).

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

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

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

Emit A seguinte sobrecarga de método pode usar o ldelem.ref opcode:

Aplica-se a