Utilisation du type dynamic (Guide de programmation C#)

Article
08/10/2011

Visual C# 2010 introduit un nouveau type, appelé dynamic. Il s'agit d'un type statique ; toutefois, un objet de type dynamic ignore la vérification des types statiques. Dans la plupart des cas, il fonctionne comme s'il était de type object. Au moment de la compilation, un élément de type dynamic est supposé prendre en charge n'importe quelle opération. Par conséquent, vous n'avez pas besoin de savoir si l'objet obtient sa valeur à partir d'une API COM, d'un langage dynamique tel qu'IronPython, du modèle d'objet de document (DOM, Document Object Model) HTML, de la réflexion ou d'une autre partie du programme. Toutefois, si le code n'est pas valide, des erreurs sont détectées au moment de l'exécution.

Par exemple, si la méthode d'instance exampleMethod1 du code suivant ne comporte qu'un seul paramètre, le compilateur reconnaît que le premier appel à la méthode, ec.exampleMethod1(10, 4), n'est pas valide car il contient deux arguments. L'appel entraîne une erreur du compilateur. Le deuxième appel à la méthode, dynamic_ec.exampleMethod1(10, 4), n'est pas vérifié par le compilateur car le type de dynamic_ec est dynamic. Par conséquent, aucune erreur de compilateur n'est signalée. Toutefois, l'erreur ne passe pas indéfiniment inaperçue. Elle est détectée au moment de l'exécution et provoque une exception runtime.

static void Main(string[] args)
{
    ExampleClass ec = new ExampleClass();
    // The following line causes a compiler error if exampleMethod1 has only
    // one parameter.
    //ec.exampleMethod1(10, 4);

    dynamic dynamic_ec = new ExampleClass();
    // The following line is not identified as an error by the
    // compiler, but it causes a run-time exception.
    dynamic_ec.exampleMethod1(10, 4);

    // The following calls also do not cause compiler errors, whether 
    // appropriate methods exist or not.
    dynamic_ec.someMethod("some argument", 7, null);
    dynamic_ec.nonexistentMethod();
}

class ExampleClass
{
    public ExampleClass() { }
    public ExampleClass(int v) { }

    public void exampleMethod1(int i) { }

    public void exampleMethod2(string str) { }
}

Le rôle du compilateur dans ces exemples consiste à regrouper les informations relatives à l'opération que chaque instruction propose d'exécuter sur l'objet ou l'expression de type dynamic. Au moment de l'exécution, les informations stockées sont examinées et toute instruction non valide provoque une exception runtime.

Le résultat de la plupart des opérations dynamiques est lui-même de type dynamic. Par exemple, si vous placez le pointeur de la souris sur testSum dans l'exemple suivant, IntelliSense affiche le type (variable locale) dynamic testSum.

dynamic d = 1;
var testSum = d + 3;
// Rest the mouse pointer over testSum in the following statement.
System.Console.WriteLine(testSum);

Les opérations dont le résultat n'est pas de type dynamic incluent les conversions du type dynamic en un autre type et les appels de constructeur qui incluent des arguments de type dynamic. Par exemple, le type de testInstance dans la déclaration suivante est ExampleClass, et non pas dynamic.

var testInstance = new ExampleClass(d);

Des exemples de conversion sont présentés dans la section suivante, « Conversions ».

Conversions

Les conversions entre les objets dynamiques et les autres types sont faciles à exécuter. Les développeurs peuvent ainsi passer du comportement dynamique au comportement non dynamique et vice versa.

Tout objet peut être converti implicitement en type dynamique, comme illustré dans les exemples suivants.

dynamic d1 = 7;
dynamic d2 = "a string";
dynamic d3 = System.DateTime.Today;
dynamic d4 = System.Diagnostics.Process.GetProcesses();

Inversement, une conversion implicite peut être appliquée de façon dynamique à toute expression de type dynamic.

int i = d1;
string str = d2;
DateTime dt = d3;
System.Diagnostics.Process[] procs = d4;

Résolution de surcharge avec des arguments de type dynamique

La résolution de surcharge a lieu au moment de l'exécution, et non pas au moment de la compilation, si un ou plusieurs arguments d'un appel de méthode sont de type dynamic ou si le récepteur de l'appel de méthode est de type dynamic. Dans l'exemple suivant, si la seule méthode exampleMethod2 accessible est définie pour accepter un argument de chaîne, l'envoi de d1 en tant qu'argument n'entraîne pas d'erreur du compilateur, mais provoque une exception runtime. La résolution de surcharge échoue au moment de l'exécution car le type de d1 au moment de l'exécution est int et exampleMethod2 requiert une chaîne.

// Valid.
ec.exampleMethod2("a string");

// The following statement does not cause a compiler error, even though ec is not
// dynamic. A run-time exception is raised because the run-time type of d1 is int.
ec.exampleMethod2(d1);
// The following statement does cause a compiler error.
//ec.exampleMethod2(7);

Dynamic Language Runtime

Le composant DLR (Dynamic Language Runtime) est une nouvelle API de .NET Framework 4. Il fournit l'infrastructure qui prend en charge le type dynamic en C#, de même que l'implémentation des langages de programmation dynamique tels qu'IronPython et IronRuby. Pour plus d'informations sur le DLR, consultez Vue d'ensemble du Dynamic Language Runtime.

COM Interop

Visual C# 2010 inclut plusieurs fonctionnalités qui améliorent l'interaction avec les API COM telles que les API d'automation Office. L'utilisation du type dynamic et des arguments nommés et facultatifs fait partie des améliorations offertes.

De nombreuses méthodes COM autorisent des variantes pour les types d'arguments et le type de retour en désignant les types comme object. Cela a nécessité un cast explicite des valeurs pour la coordination avec les variables fortement typées en C#. Si vous effectuez la compilation à l'aide de l'option /link (Options du compilateur C#), l'introduction du type dynamic vous permet de traiter les occurrences d'object dans les signatures COM comme si elles étaient de type dynamic, vous évitant ainsi une grande partie des opérations de cast. Par exemple, les instructions suivantes permettent de comparer la façon dont vous accédez à une cellule d'une feuille de calcul Microsoft Office Excel avec le type dynamic et sans le type dynamic.

// Before the introduction of dynamic.
((Excel.Range)excelApp.Cells[1, 1]).Value2 = "Name";
Excel.Range range2008 = (Excel.Range)excelApp.Cells[1, 1];

// After the introduction of dynamic, the access to the Value property and
// the conversion to Excel.Range are handled by the run-time COM binder.
excelApp.Cells[1, 1].Value = "Name";
Excel.Range range2010 = excelApp.Cells[1, 1];

Rubriques connexes

Titre	Description
dynamic (Référence C#)	Décrit l'utilisation du mot clé dynamic.
Vue d'ensemble du Dynamic Language Runtime	Fournit une vue d'ensemble du DLR, qui est un environnement d'exécution ajoutant au common language runtime (CLR) un ensemble de services pour les langages dynamiques.
Procédure pas à pas : création et utilisation d'objets dynamiques (C# et Visual Basic)	Fournit des instructions pas à pas pour la création d'un objet dynamique personnalisé et pour la création d'un projet qui accède à une bibliothèque IronPython.
Comment : accéder aux objets Office Interop à l'aide des fonctionnalités Visual C# 2010 (Guide de programmation C#)	Montre comment créer un projet qui utilise les arguments nommés et facultatifs, le type dynamic et d'autres améliorations qui simplifient l'accès aux objets d'API Office.