OpCodes.Callvirt Campo

public: static initonly System::Reflection::Emit::OpCode Callvirt;

public static readonly System.Reflection.Emit.OpCode Callvirt;

 staticval mutable Callvirt : System.Reflection.Emit.OpCode

Public Shared ReadOnly Callvirt As OpCode 

Valor do campo

Comentários

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

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

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

2. Os argumentos de método são enviados arg1argN por push para a pilha.

3. Argumentos arg1 de método e argN a referência obj de objeto são extraídos da pilha; a chamada de método é executada com esses argumentos e o controle é transferido para o método no obj token de metadados do método. Quando concluído, um valor retornado é gerado pelo método de destinatário do chamador e enviado ao chamador.

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

A callvirt instrução chama um método de associação tardia em um objeto. Ou seja, o método é escolhido com base no tipo de runtime em vez da obj classe de tempo de compilação visível no ponteiro do método. Callvirt pode ser usado para chamar métodos virtuais e de instância. A callvirt instrução pode ser imediatamente precedida por um tail prefixo (Tailcall) para especificar que o quadro de pilha atual deve ser liberado antes de transferir o controle. Se a chamada transferir o controle para um método de maior confiança do que o método original, o quadro de pilha não será liberado.

O token de metadados do método fornece o nome, a classe e a assinatura do método a ser chamado. A classe associada obj é a classe à qual ela é uma instância. Se a classe definir um método não estático que corresponda ao nome e à assinatura do método indicados, esse método será chamado. Caso contrário, todas as classes na cadeia de classes base dessa classe serão verificadas em ordem. Será um erro se nenhum método for encontrado.

Callvirt exibe o objeto e os argumentos associados da pilha de avaliação antes de chamar o método. Se o método tiver um valor retornado, ele será enviado por push na pilha após a conclusão do método. No lado do receptor, o obj parâmetro é acessado como argumento 0, arg1 como argumento 1 e assim por diante.

Os argumentos são colocados na pilha na ordem da esquerda para a direita. Ou seja, o primeiro argumento é computado e colocado na pilha, depois no segundo argumento, depois no terceiro, até que todos os argumentos necessários estejam em cima da pilha em ordem decrescente. A referência obj de instância (sempre necessária para ) deve ser enviada por callvirtpush antes de qualquer um dos argumentos visíveis pelo usuário. A assinatura (carregada no token de metadados) não precisa conter uma entrada na lista de parâmetros para esse ponteiro.

Observe que um método virtual também pode ser chamado usando a Call instrução.

MissingMethodException será gerado se um método não estático com o nome indicado e a assinatura não puderem ser encontrados na classe associada obj ou em qualquer uma de suas classes base. Isso normalmente é detectado quando Microsoft instruções msil (linguagem intermediária) são convertidas em código nativo, em vez de em runtime.

NullReferenceException será gerado se o obj for nulo.

SecurityException será gerada se a segurança do sistema não conceder ao chamador acesso ao método chamado. A verificação de segurança pode ocorrer quando o CIL é convertido em código nativo em vez de em tempo de execução.

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

• ILGenerator.Emit(OpCode, MethodInfo)

• ILGenerator.EmitCall(OpCode, MethodInfo, Type[])