Partager via


Comment : inclure des ressources au moment de la compilation

En principe, il est facile et pratique de travailler avec la disposition par défaut de toutes les ressources présentes dans un fichier de script de ressources (.rc). Il est néanmoins possible d'ajouter à votre projet en cours des ressources provenant d'autres fichiers au moment de la compilation en les répertoriant dans la zone Directives de compilation de la boîte de dialogue Include des ressources.

Il existe plusieurs raisons pour placer des ressources dans un fichier autre que le fichier principal .rc :

  • Ajouter des commentaires aux instructions de ressource qui ne seront pas supprimées lors de l'enregistrement du fichier .rc.

    Les Éditeurs de ressources ne lisent pas directement les fichiers read .rc ou resource.h. Le compilateur de ressources les compile en fichiers .aps qui sont ensuite consommés par les Éditeurs de ressources. Ce fichier est une étape de la compilation et ne stocke que les données symboliques. Comme dans un processus de compilation classique, les informations non symboliques (les commentaires, par exemple) sont supprimées pendant la compilation. Chaque fois que le fichier .aps n'est plus synchronisé avec le fichier .rc, celui-ci est régénéré (ainsi, pendant l'enregistrement, l'Éditeur de ressources remplace les fichiers .rc et resource.h). Toutes les modifications apportées aux ressources sont conservées dans le fichier .rc, à l'exception des commentaires qui seront perdus lors du remplacement du fichier .rc.

  • Inclure des ressources qui ont déjà été développées et testées et n'ont plus besoin d'être modifiées. (Tous les fichiers inclus mais dépourvus d'extension .rc ne sont pas modifiables par les Éditeurs de ressources.)

  • Inclure des ressources utilisées par plusieurs projets différents ou faisant partie d'un système de contrôle de versions du code source, et qui doivent par conséquent ne pas se trouver dans un emplacement centralisé où les modifications affectent tous les projets.

  • Inclure des ressources (telles que des ressources RCDATA) qui sont au format personnalisé. Les ressources RCDATA peuvent avoir des besoins particuliers. Par exemple, vous ne pouvez pas utiliser une expression comme valeur du champ nameID. Pour plus d'informations, consultez la documentation du Kit de développement logiciel Windows.

Si vos fichiers .rc comportent des sections qui répondent à ces conditions, vous devez placer les placer dans un ou plusieurs fichiers .rc séparés et les inclure dans votre projet à l'aide de la boîte de dialogue Include des ressources. Le fichier Projectname.rc2 créé dans le sous-répertoire \res d'un nouveau projet est utilisé à cette fin.

Pour inclure des ressources à votre projet au moment de la compilation

  1. Placez les ressources dans un fichier de script de ressources portant un nom de fichier unique. N'utilisez pas projectname.rc, car ce nom de fichier est utilisé pour le fichier de script de ressources principal.

  2. Dans l'Affichage des ressources, cliquez avec le bouton droit sur le fichier .rc, puis sélectionnez Include des ressources dans le menu contextuel.

  3. Dans la zone Directives de compilation, ajoutez la directive du compilateur #include pour inclure le nouveau fichier de ressources dans le fichier de ressources principal de l'environnement de développement.

    Les ressources des fichiers incluses de cette façon sont intégrées à votre fichier exécutable au moment de la compilation. Elles ne sont pas disponibles directement à des fins d'édition ou de modification lorsque vous travaillez sur le fichier .rc principal de votre projet. Vous devez ouvrir les fichiers .rc inclus séparément. Tous les fichiers inclus mais dépourvus de l'extension .rc ne sont pas modifiables par les Éditeurs de ressources.

Pour plus d'informations sur l'ajout de ressources aux projets managés, consultez Ressources dans les applications dans le Guide du développeur .NET Framework. Pour obtenir des informations sur l'ajout de fichiers de ressources aux projets managés, l'accès aux ressources, l'affichage de ressources statiques et l'assignation de chaînes de ressources aux propriétés, et ce manuellement, consultez Procédure pas à pas : localisation des applications Windows Forms et Walkthrough: Using Resources for Localization with ASP.NET.

Configuration requise

Win32

Voir aussi

Référence

Fichiers de ressources (Visual Studio)

Éditeurs de ressources