Classe System.Reflection.Emit.MethodBuilder

Este artigo fornece observações complementares à documentação de referência para essa API.

A MethodBuilder classe é usada para descrever completamente um método em linguagem intermediária comum (CIL), incluindo o nome, atributos, assinatura e corpo do método. Ele é usado em conjunto com a TypeBuilder classe para criar classes em tempo de execução.

Você pode usar a emissão de reflexão para definir métodos globais e definir métodos como membros do tipo. As APIs que definem métodos retornam MethodBuilder objetos.

Métodos globais

Um método global é definido usando o ModuleBuilder.DefineGlobalMethod método, que retorna um MethodBuilder objeto.

Os métodos globais devem ser estáticos. Se um módulo dinâmico contiver métodos globais, o ModuleBuilder.CreateGlobalFunctions método deverá ser chamado antes de persistir o módulo dinâmico ou o assembly dinâmico que o contém, pois o Common Language Runtime adia a correção do módulo dinâmico até que todas as funções globais tenham sido definidas.

Um método nativo global é definido usando o ModuleBuilder.DefinePInvokeMethod método. Os métodos de invocação de plataforma (PInvoke) não devem ser declarados abstratos ou virtuais. O tempo de execução define o MethodAttributes.PinvokeImpl atributo para um método de invocação de plataforma.

Métodos como membros de tipos

Um método é definido como um membro do tipo usando o TypeBuilder.DefineMethod método, que retorna um MethodBuilder objeto.

O DefineParameter método é usado para definir os atributos name e parameter de um parâmetro ou do valor de retorno. O ParameterBuilder objeto retornado por esse método representa um parâmetro ou o valor de retorno. O ParameterBuilder objeto pode ser usado para definir o empacotamento, definir o valor constante e aplicar atributos personalizados.

Atributos

Os membros da MethodAttributes enumeração definem o caráter preciso de um método dinâmico:

• Os métodos estáticos são especificados usando o MethodAttributes.Static atributo .
• Os métodos finais (métodos que não podem ser substituídos) são especificados usando o MethodAttributes.Final atributo .
• Os métodos virtuais são especificados usando o atributo MethodAttributes.Virtual .
• Métodos abstratos são especificados usando o MethodAttributes.Abstract atributo .
• Vários atributos determinam a visibilidade do método. Consulte a descrição da MethodAttributes enumeração.
• Os métodos que implementam operadores sobrecarregados devem definir o MethodAttributes.SpecialName atributo.
• Os finalizadores devem definir o MethodAttributes.SpecialName atributo.

Problemas conhecidos

• Embora MethodBuilder seja derivado do MethodInfo, alguns dos métodos abstratos definidos na MethodInfo classe não são totalmente implementados no MethodBuilder. Esses MethodBuilder métodos lançam o NotSupportedException. Por exemplo, o MethodBuilder.Invoke método não está totalmente implementado. Você pode refletir sobre esses métodos recuperando o tipo de delimitação usando os Type.GetType métodos ou Assembly.GetType .
• Há suporte para modificadores personalizados.