Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

dynamic — associação de operações em tempo de execução

O tipo dynamic adia a associação das operações para tempo de execução. Facilita a interação com APIs dinâmicas, mas membros inexistentes ou argumentos incompatíveis podem causar RuntimeBinderException em vez de um erro de compilação.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

dynamic name = expression;

dynamic permite adiar a verificação e a associação de determinadas operações para tempo de execução. O compilador regista informações sobre a operação e o binder resolve-a mais tarde, recorrendo, entre outros elementos, aos tipos reais dos valores. Esta funcionalidade existe desde C# 4; não é nova nem uma funcionalidade preview no .NET 10. A definição do repositório LangVersion=preview não é necessária.

Ao contrário de dynamic, var infere o tipo do inicializador: em var x = 42, a variável tem o tipo int e é verificada estaticamente. object também mantém a verificação estática das operações disponíveis; o acesso a membros de um tipo específico exige normalmente uma conversão ou correspondência de padrões. dynamic é representado como object, não como um tipo de execução distinto. Atribuir-lhe um valor não altera o tipo desse valor nem lhe acrescenta membros.

A associação dinâmica através de DLR utiliza a infraestrutura Dynamic Language Runtime. System.Runtime.CompilerServices.CallSite<T> representa um ponto de chamada dinâmica; T é o tipo do delegado e as regras em cache reduzem a necessidade de voltar a associar. System.Dynamic.IDynamicMetaObjectProvider permite que um objeto forneça o seu próprio comportamento de associação através de GetMetaObject. Um objeto .NET comum não precisa de implementar esta interface para ser usado com dynamic.

Chamadas com um recetor ou argumentos dinâmicos podem selecionar uma sobrecarga apenas em tempo de execução. O resultado da maioria das operações dinâmicas também tem o tipo dynamic; atribuí-lo, por exemplo, a int requer uma conversão válida, verificada em tempo de execução. Uma associação falhada, como a leitura de uma propriedade inexistente, causa Microsoft.CSharp.RuntimeBinder.RuntimeBinderException. As exceções lançadas por um método invocado com sucesso não se tornam automaticamente esta exceção.

Utilize dynamic nas fronteiras de integração com COM ou APIs dinâmicas e prefira tipos estáticos quando o contrato é conhecido. Perde alguma verificação do compilador e incorre no custo da associação. No exemplo, Length funciona para string, mas, depois de atribuir um int, o mesmo nome de propriedade provoca uma falha de associação tratada.

Exemplos

using System;
using Microsoft.CSharp.RuntimeBinder;

internal static class Program
{
    private static void Main()
    {
        dynamic value = "hello";
        int length = value.Length;
        Console.WriteLine(length);

        value = 42;
        Console.WriteLine(value + 1);

        try
        {
            Console.WriteLine(value.Length);
        }
        catch (RuntimeBinderException)
        {
            Console.WriteLine("RuntimeBinderException");
        }
    }
}

Resultado

5
43
RuntimeBinderException

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes