Page Ressources, Concepteur de projets

Le Concepteur de ressources est un outil d'interface utilisateur qui vous permet de gérer les ressources (telles que des chaînes, des images, des icônes, des sons et des fichiers) de votre projet.

La page Ressources du Concepteur de projets héberge une instance du Concepteur de ressources qui stocke et maintient des ressources dans un emplacement unique (Resources.resx).

Le Concepteur de ressources est indépendant du langage et prend en charge les projets dans tous les langages de Visual Studio.Les éléments que vous ajoutez au projet à l'aide du Concepteur de ressources sont placés dans le répertoire Ressources de votre projet.Les informations relatives au concepteur sont stockées dans un fichier nommé Resources.resx et le code de la ressource dans Resources.Designer.cs, Resources.Designer.vb ou Resources.Designer.jsl.

Vous pouvez également utiliser le Concepteur de ressources pour modifier des fichiers .resx autonomes.Par exemple, si vous ajoutez un fichier de ressources à l'aide de l'Explorateur de solutions, ses paramètres sont conservés dans un fichier .resx séparé et n'apparaissent pas dans le Concepteur de projets.Le double-clic sur le fichier .resx d'une ressource ouvre un Concepteur de ressources distinct pour cette ressource.

Vous pouvez modifier des ressources basées sur des fichiers en double-cliquant sur la ressource dans le Concepteur de ressources.Le Concepteur de ressources ouvre l'élément dans l'éditeur par défaut pour ce type de fichier.Si aucun éditeur n'est enregistré pour ce type de fichier, le fichier s'ouvre dans l'application par défaut de Windows pour ce type.Pour modifier l'association de type de fichier, consultez Comment : associer un éditeur à un type de ressource.

Pour Visual C#, le Concepteur de ressources génère des ressources fortement typées dans l'espace de noms par défaut du projet (plus particulièrement, NomProjet.Properties dans Resources.Designer.cs).

En Visual Basic, le Concepteur de ressources génère des ressources fortement typées dans l'espace de noms My.Resources (dans Resources.Designer.vb).Pour plus d'informations sur l'accès aux ressources en Visual Basic à l'aide de l'objet My.Resources, consultez Accès aux ressources de l'application.

Les ressources fortement typées encapsulent l'accès aux ressources en créant des classes qui contiennent un jeu de propriétés (Get) statiques en lecture seule au moment de la compilation.Vous pouvez consommer des ressources à l'aide des propriétés (Get) plutôt qu'à l'aide des méthodes GetString et GetObject de la classe ResourceManager.Les ressources fortement typées simplifient également le développement d'applications localisables.Pour plus d'informations sur les ressources fortement typées, consultez StronglyTypedResourceBuilder.

Les ressources ont également une propriété Persistence qui spécifie si elles sont liées ou incorporées.Les ressources liées sont stockées comme fichiers dans le projet ; le fichier .resx stocke un chemin d'accès relatif au fichier et, pendant la compilation, les données de ressources sont placées dans le manifeste pour l'application.Avec les ressources incorporées, les données de ressources sont stockées directement dans le fichier .resx.

Par défaut, toutes les nouvelles ressources sont liées et non incorporées.Si vous essayez de modifier une ressource incorporée, un message vous invite à convertir l'élément en une ressource liée pour la modifier ; la conversion est facultative, mais recommandée.Pour plus d'informations, consultez Ressources liées et incorporées.

Pour accéder à la page Ressources, sélectionnez un nœud de projet dans l'Explorateur de solutions, puis cliquez sur Propriétés dans le menu Projet.Lorsque le Concepteur de projets apparaît, cliquez sur l'onglet Ressources.

Sélecteur d'affichage des ressources

Pour afficher les ressources d'un projet par type, dans le coin supérieur gauche de la page Ressources, cliquez sur la flèche, puis sélectionnez un type de ressource dans la liste déroulante.Les choix sont Chaînes, Images, Icônes, Audio, Fichiers et Autre.Chaînes est l'affichage par défaut.La liste suivante décrit les différents affichages.

• Chaînes
  Affiche les chaînes dans une grille disposant de colonnes pour le Nom, la Valeur et le Commentaire de la ressource de type chaîne.Vous pouvez accéder aux ressources en tant que String en utilisant My.Resources au moment de l'exécution.Pour une description des colonnes de cette grille, consultez la section Grille des paramètres traitée ultérieurement dans cette rubrique.

• Images
  Affiche tous les fichiers image, y compris les formats .bmp, .jpg et .gif.Ces fichiers sont exposés au moment de l'exécution en tant que Bitmap.Cette catégorie inclut également des métafichiers Windows, exposés en tant que Metafile.

• Icônes
  Affiche les fichiers icône (.ico) qui sont exposés en tant que Icon.

• Audio
  Affiche les fichiers audio, y compris les fichiers .wav, .wma et .mp3.Ces fichiers sont exposés en tant que tableaux d'octets.Double-cliquez sur un élément audio pour l'ouvrir et le lire dans le Lecteur Windows Media.

• Fichiers
  Affiche tous les fichiers qui n'entrent pas dans les catégories précitées.Les éléments dans cet affichage peuvent être des fichiers texte exposés en tant que String ou des fichiers binaires exposés en tant que tableaux d'octets.

• Autre
  Affiche une grille de paramètres pour ajouter d'autres types qui prennent en charge la sérialisation de chaînes (par exemple, Font, Enum, Coloret Point).La grille contient les colonnes suivantes : Nom, Type, Valeur et Commentaire.Pour une description des colonnes de cette grille, consultez la section Grille des paramètres traitée ultérieurement dans cette rubrique.

Ajouter une ressource, Supprimer une ressource et Modificateur d'accès

Ces contrôles vous permettent d'ajouter et de supprimer des ressources.Ils vous permettent également de modifier le niveau d'accès des classes générées My.Resources.

• Ajouter une ressource
  Pour ajouter une ressource, sélectionnez un élément dans la liste déroulante Ajouter une ressource en haut de la page.Les options sont : Ajouter un fichier existant, Ajouter une nouvelle chaîne, Nouvelle image (format PNG, BMP, GIF, JPEG ou TIFF), Ajouter une nouvelle icône et Ajouter un nouveau fichier texte.

• Supprimer une ressource
  Sélectionnez une ressource existante dans la grille de paramètres (décrit ci-dessous) et cliquez sur Supprimer une ressource pour la supprimer.

• Modificateur d'accès
  Cette option est disponible dans les Concepteurs de ressources pour les fichiers de ressources que vous ajoutez à un projet et dans le Concepteur de ressources par défaut (Resources.resx).

  Cette option spécifie le niveau d'accès des classes d'assistance My.Resources que Visual Studio génère dans Resources.Designer.cs ou Resources.Designer.vb.Les classes My.Resources fournissent l'accès d'exécution aux ressources.

  Pour les projets Visual C#, le modificateur d'accès peut être Interne, Public ou Pas de génération de code.

  Pour les projets Visual Basic, le modificateur d'accès peut être Friend, Public ou Pas de génération de code.

  Le paramètre par défaut est Interne (en C#) ou Friend (dans Visual Basic).Lorsque Visual Studio génère des classes d'assistance dont la valeur est Internal ou Friend, les applications exécutables (.exe) ne peuvent pas accéder aux ressources et aux paramètres ajoutés aux bibliothèques de classes (fichiers .DLL).Si vous devez partager des ressources et des paramètres à partir d'un fichier DLL, affectez la valeur Public au modificateur d'accès.

  Pour les fichiers de ressources localisés (par exemple, NomProjet.de-DE.resx), vous devez définir le modificateur d'accès sur Pas de génération de code pour que votre application puisse automatiquement accéder au fichier de ressources localisé approprié au moment de l'exécution.Pour plus d'informations sur les ressources localisées, consultez Comment : créer une version localisée d'un fichier de ressources.Le modificateur d'accès Pas de génération de code n'est pas disponible pour le Concepteur de ressources par défaut.

Grille de paramètres

La grille des paramètres permet de configurer les paramètres des ressources de type chaîne.Cette grille apparaît uniquement dans les affichages Chaînes et Autre.Cette grille inclut les colonnes suivantes.

• Name
  Tapez le nom de la ressource dans ce champ.

• Type
  Spécifiez un type qui prend en charge la sérialisation de chaîne.(Cette colonne apparaît uniquement dans l'affichage Autre.)

• Valeurs
  Spécifiez la valeur associée au paramètre de la ressource.Par exemple, si la ressource est une chaîne, vous devez entrer sa valeur texte ici.

• Commentaire
  Si vous le souhaitez, tapez un commentaire qui décrit la ressource de type chaîne.Vous pouvez uniquement l'afficher au moment du design.

Voir aussi

Tâches

Comment : ajouter ou supprimer des ressources

Comment : ajouter ou supprimer des ressources chaîne

Comment : modifier des ressources

Comment : modifier des ressources chaîne

Comment : associer un éditeur à un type de ressource

Comment : créer des ressources incorporées

Comment : importer ou exporter des ressources

Concepts

Ressources liées et incorporées

Accès aux ressources de l'application

Autres ressources

Gestion des ressources de l'application