Partager via

alias extern (référence C#)

Vous devrez peut-être référencer deux versions d’assemblys qui ont les mêmes noms de types complets. Par exemple, vous devrez peut-être utiliser deux versions ou plus d’un assembly dans la même application. En utilisant un alias d’assembly externe, vous pouvez encapsuler les espaces de noms de chaque assembly à l’intérieur des espaces de noms de niveau racine nommés par l’alias. Cette approche vous permet d’utiliser les deux versions dans le même fichier.

La documentation de référence du langage C# décrit la version la plus récente du langage C#. Il contient également la documentation initiale des fonctionnalités dans les préversions publiques pour la prochaine version du langage.

La documentation identifie toute fonctionnalité introduite en premier dans les trois dernières versions de la langue ou dans les préversions publiques actuelles.

Conseil / Astuce

Pour savoir quand une fonctionnalité a été introduite en C#, consultez l’article sur l’historique des versions du langage C#.

Remarque

Le mot clé extern est également utilisé comme modificateur de méthode, déclarant une méthode écrite dans du code non managé.

Pour référencer deux assemblys avec les mêmes noms de types complets, spécifiez un alias dans votre fichier .csproj et ajoutez le code suivant :

<Reference Include="grid.dll"> 
    <Aliases>GridV1</Aliases>
</Reference>
<Reference Include="grid20.dll">
    <Aliases>GridV2</Aliases>
</Reference>

Vous pouvez en savoir plus dans l’article sur la tâche CSC dans la documentation de Visual Studio.

Cette commande crée les alias GridV1 externes et GridV2. Pour utiliser ces alias à partir d’un programme, référencez-les à l’aide du extern mot clé. Par exemple:

extern alias GridV1; extern alias GridV2;

Chaque déclaration d’alias extern introduit un espace de noms de niveau racine supplémentaire qui est parallèle (mais qui ne se trouve pas dans) l’espace de noms global. Vous pouvez faire référence aux types de chaque assembly sans ambiguïté en utilisant leur nom complet, rooté dans l’alias d’espace de noms approprié.

Dans l’exemple précédent, GridV1::Grid est le contrôle de grille à partir de grid.dll, et GridV2::Grid est le contrôle de grille à partir de grid20.dll.

Utilisation de Visual Studio

Si vous utilisez Visual Studio, vous pouvez fournir des alias de manière similaire.

Ajoutez des références à grid.dll et grid20.dll à votre projet dans Visual Studio. Ouvrez l’onglet de propriété et modifiez les alias de global vers GridV1 et GridV2 respectivement.

Utilisez ces alias de la même façon que décrit précédemment.

extern alias GridV1;  
extern alias GridV2;

Vous pouvez maintenant créer un alias pour un espace de noms ou un type à l’aide de la directive d’alias using. Pour plus d’informations, consultez la directive using.

using Class1V1 = GridV1::Namespace.Class1;
using Class1V2 = GridV2::Namespace.Class1;

Spécification du langage C#

Pour plus d'informations, voir la spécification du langage C#. La spécification du langage est la source de référence pour la syntaxe C# et son utilisation.

Voir aussi

  • Last updated on