Ler em inglês

Compartilhar via


CallingConventions Enumeração

Definição

Define as convenções de chamada válidas para um método.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

C#
[System.Flags]
public enum CallingConventions
C#
[System.Flags]
[System.Serializable]
public enum CallingConventions
C#
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum CallingConventions
Herança
CallingConventions
Atributos

Campos

Nome Valor Description
Any 3

Especifica que a convenção de chamada Standard ou VarArgs pode ser usada.

ExplicitThis 64

Especifica que a assinatura é uma assinatura de ponteiro de função, que representa uma chamada para um método virtual ou de instância (não um método estático). Se ExplicitThis for definido, HasThis também deverá ser definido. O primeiro argumento passado para o método chamado ainda é um ponteiro this, mas o tipo do primeiro argumento agora é desconhecido. Portanto, um token que descreve o tipo (ou classe) do ponteiro this é explicitamente armazenado em sua assinatura de metadados.

HasThis 32

Especifica um método virtual ou de instância (não um método estático). No tempo de execução, o método chamado é passado em um ponteiro para o objeto de destino como seu primeiro argumento (o ponteiro this). A assinatura armazenada nos metadados não inclui o tipo desse primeiro argumento, pois o método é conhecido e sua classe de proprietário pode ser descoberta dos metadados.

Standard 1

Especifica a convenção de chamada padrão conforme determinado pelo Common Language Runtime. Use esta convenção de chamada para métodos estáticos. Para métodos virtuais ou de instância, use HasThis.

VarArgs 2

Especifica a convenção de chamada de métodos com argumentos variáveis.

Exemplos

C#
using System;
using System.Reflection;
using System.Security;

public class MyClass3
{
    public MyClass3(int i) { }
    public static void Main()
    {
        try
        {
            Type myType = typeof(MyClass3);
            Type[] types = new Type[1];
            types[0] = typeof(int);
            // Get the public instance constructor that takes an integer parameter.
            ConstructorInfo constructorInfoObj = myType.GetConstructor(
                BindingFlags.Instance | BindingFlags.Public, null,
                CallingConventions.HasThis, types, null);
            if (constructorInfoObj != null)
            {
                Console.WriteLine("The constructor of MyClass3 that is a public " +
                    "instance method and takes an integer as a parameter is: ");
                Console.WriteLine(constructorInfoObj.ToString());
            }
            else
            {
                Console.WriteLine("The constructor of MyClass3 that is a public instance " +
                    "method and takes an integer as a parameter is not available.");
            }
        }
        catch (ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException: " + e.Message);
        }
        catch (ArgumentException e)
        {
            Console.WriteLine("ArgumentException: " + e.Message);
        }
        catch (SecurityException e)
        {
            Console.WriteLine("SecurityException: " + e.Message);
        }
        catch (Exception e)
        {
            Console.WriteLine("Exception: " + e.Message);
        }
    }
}

Comentários

A convenção de chamada nativa é o conjunto de regras que regem a ordem e o layout dos argumentos passados para métodos compilados. Ele também controla como passar o valor retornado, quais registros usar para argumentos e se o chamado ou o método de chamada remove argumentos da pilha.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0