Ressources liées et incorporées

Article
02/28/2013

Les projets Visual Studio fournissent deux options pour gérer les ressources : celles-ci peuvent être liées (par défaut) ou incorporées.Vous pouvez avoir à la fois des ressources liées et incorporées dans un même projet.Toutefois, la plupart du temps, vous souhaiterez choisir une option pour toutes les ressources du projet.

Les ressources liées sont stockées comme des fichiers dans le projet. Pendant la compilation, les données de ressources sont extraites des fichiers et ajoutées au manifeste de l'application.Le fichier de ressources (.resx) de l'application stocke uniquement un chemin d'accès relatif ou un lien au fichier sur le disque.

Avec les ressources incorporées, les données de ressources sont stockées directement dans le fichier .resx dans une représentation textuelle des données binaires.Dans l'un et l'autre cas, les données de ressources sont compilées dans le fichier exécutable.

Les ressources peuvent passer de la valeur « liées » à « incorporées » en modifiant la propriété Persistence du fichier de ressources.Pour plus d'informations, consultez créer des ressources incorporées plus loin dans cette rubrique.

[!REMARQUE]

Les ressources de type chaîne sont toujours incorporées et ne peuvent pas être modifiées. Les ressources de fichier sont toujours liées et ne peuvent pas être modifiées.

Choix entre des ressources liées et incorporées

En général, vous devez utiliser des ressources liées, car elles sont plus faciles à utiliser.Toutefois, il est des cas où les ressources incorporées peuvent s'avérer un meilleur choix.

Ressources incorporées

Les ressources incorporées sont le meilleur choix si vous devez partager des fichiers de ressources d'application (.resx) entre plusieurs projets.Par exemple, si vous disposez d'un fichier de ressources communes contenant des informations telles que les logos et les informations relatives aux marques de votre société, l'utilisation de ressources incorporées signifie que vous pouvez vous contenter de copier le fichier .resx et non les fichiers de données de ressources associés.

Vous ne pouvez pas modifier directement les ressources incorporées.Si vous essayez de modifier une ressource incorporée, un message s'affiche pour vous inviter à convertir préalablement l'élément en une ressource liée.La conversion est recommandée, mais facultative.Vous devez les exporter, effectuer vos modifications dans un programme externe, puis les réimporter dans votre projet.

créer des ressources incorporées

Lorsque vous ajoutez des ressources à un projet Visual Studio, celles-ci sont créées comme des ressources liées.Dans quelques cas, vous pouvez vouloir incorporer les ressources dans le fichier de ressources d'application (.resx).

Les ressources peuvent passer de la valeur « liées » à « incorporées » sur la page Ressources du Concepteur de projets.

[!REMARQUE]

Les ressources de type chaîne sont toujours incorporées dans le fichier .resx et ne peuvent pas être changées en ressources liées. Les ressources de fichier sont toujours liées au moment de la compilation.

Pour changer une ressource de ressource liée en ressource incorporée

Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Propriétés.
Cliquez sur l'onglet Ressources.
Dans la barre d'outils du Concepteur de ressources, pointez sur la liste déroulante de l'affichage des ressources, cliquez sur la flèche et sélectionnez le type de ressource que vous souhaitez modifier.
Sélectionnez la ressource que vous voulez modifier.
Dans la fenêtre Propriétés, sélectionnez la propriété Persistance et affectez-lui la valeur Incorporé dans .resx.

ressources incorporées en modification

Les ressources incorporées dans un projet Visual Studio ne peuvent pas être modifiées directement dans l'IDE de Visual Studio. Vous devez les exporter et les modifier dans un programme externe, puis les réimporter dans le projet.

Pour exporter une ressource incorporée

Sélectionnez un projet dans l'Explorateur de solutions, puis, dans le menu Projet, cliquez sur Propriétés.
Cliquez sur l'onglet Ressources.La page Concepteur de ressources apparaît avec une barre d'outils.
Dans la première zone déroulante de la barre d'outils du Concepteur de ressources, sélectionnez le type de ressource incorporée à importer, tel que « Images », « Icônes » ou « Audio ». Toutes les ressources de ce type présentes dans le projet apparaissent dans le Concepteur de ressources.
Sélectionnez la ressource que vous voulez exporter, par exemple, une icône ou un fichier audio.
Cliquez avec le bouton droit sur la ressource, puis sélectionnez Exporter vers un fichier dans le menu contextuel.

[!REMARQUE]

Cette commande est uniquement disponible pour les ressources incorporées.
Dans la boîte de dialogue Exporter la ressource dans le fichier, naviguez jusqu'à l'emplacement où vous souhaitez exporter le fichier, puis cliquez sur Enregistrer.

Pour importer une ressource

Sélectionnez un projet dans l'Explorateur de solutions, puis, dans le menu Projet, cliquez sur Propriétés.
Cliquez sur l'onglet Ressources.La page Concepteur de ressources apparaît.
Dans la première zone déroulante de la barre d'outils du Concepteur de ressources, sélectionnez le type de ressource incorporée à importer, tel que « Images », « Icônes » ou « Audio ». Toutes les ressources de ce type présentes dans le projet apparaissent dans le Concepteur de ressources.
Sélectionnez la ressource que vous voulez importer, par exemple, une icône ou un fichier audio.
Cliquez avec le bouton droit sur la ressource, puis sélectionnez Importer à partir d'un fichier dans le menu contextuel.

[!REMARQUE]

Cette commande est uniquement disponible pour les ressources incorporées.
Dans la boîte de dialogue Importer le fichier dans la ressource, naviguez jusqu'au fichier que vous voulez importer, puis cliquez sur Ouvrir.