OpCodes.Ldelem_Ref Campo

Definição

Namespace:

System.Reflection.Emit

Assembly:

System.Reflection.Primitives.dll

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:

• ILGenerator.Emit(OpCode)