Création de fichiers de ressources
Mise à jour : novembre 2007
La bibliothèque de classes de base du .NET Framework fournit plusieurs classes dans l'espace de noms System.Resources pour vous aider à créer et à manipuler des ressources dans vos applications. Pour une description détaillée de l'utilisation de chaque classe, cliquez sur le lien pour afficher la rubrique de référence correspondante.
Classe |
Description |
|---|---|
Lit les ressources d'un flux. |
|
Écrit les ressources dans un flux. |
|
Lit les ressources au format du fichier de ressources binaire par défaut du runtime. Il s'agit de l'implémentation par défaut de l'interface IResourceReader. |
|
Écrit les ressources au format du fichier de ressources binaire par défaut du runtime. Il s'agit de l'implémentation par défaut de l'interface IResourceWriter. |
|
Permet de récupérer les ressources créées à partir de fichiers .resx. Il s'agit de l'implémentation spécialisée de l'interface IResourceReader. |
|
Permet de créer un fichier .resx à partir de ressources spécifiques. Il s'agit de l'implémentation spécialisée de l'interface IResourceWriter. Utilisez l'outil Resource File Generator Tool (Resgen.exe) pour convertir le fichier .resx au format de fichier .resources. |
Vous pouvez créer des fichiers de ressources de trois façons différentes. Si votre ressource contient uniquement des chaînes, la façon la plus simple est de créer un fichier texte manuellement. Si vos ressources vont contenir des objets ou une combinaison de chaînes et d'objets, vous devez créer un fichier .resx ou un fichier .resources. Pour plus d'informations sur chaque type de fichier, cliquez sur le lien correspondant.
.gif "Remarque") Remarque : |
|---|
N'utilisez pas de fichiers de ressources pour stocker des mots de passe, des informations sensibles ou des données privées. |
Pour écrire des objets rendus persistants dans un fichier de ressources, les objets doivent être sérialisables. .Les types .NET Framework, tels que string et integer ainsi qu'un groupe de types Windows Forms, tels que Bitmap, Icon et Image, peuvent être désérialisés par du code de niveau de confiance partiel. Pour que les autres types soient désérialisés, le code qui les appelle doit avoir SecurityPermission avec l'indicateur SerializationFormatter spécifié.
Les ressources marquées comme privées sont accessibles uniquement dans l'assembly dans lequel elles se trouvent. Dans la mesure où un assembly satellite ne contient aucun code, les ressources qui lui sont privées deviennent indisponibles quel que soit le mécanisme. Par conséquent, les ressources dans les assemblys satellites doivent toujours être publiques de façon à être accessibles à partir de votre assembly principal. Les ressources incorporées dans votre assembly principal lui sont accessibles, qu'il soit privé ou public.
Votre application ne doit jamais dépendre des ressources d'un assembly que vous n'avez pas créé, puis fourni avec votre application. Des dépendances par rapport à des ressources tierces peuvent provoquer l'échec de votre application étant donné que la présence de ces ressources dans une future version ou dans un éventuel Service Pack n'est pas garantie.
Seuls des fichiers .resources doivent être incorporés dans des assemblys satellites et du Common Language Runtime. L'outil Resource File Generator Tool (Resgen.exe) convertit des fichiers texte (.txt) et des fichiers de ressources XML (.resx) en fichiers .resources en encapsulant des méthodes implémentées par les classes ResourceReader, ResourceWriter, ResXResourceReader et ResXResourceWriter. Vous pouvez également utiliser Resgen.exe pour convertir des fichiers .resources en fichiers .resx et .txt.
Le Kit de développement logiciel (SDK) Windows Microsoft fournit plusieurs exemples qui illustrent l'utilisation des fichiers .resource. Consultez Ressources dans les applications, l'exemple de localisation ASP.NET et le Démarrage rapide pour les tâches courantes Comment : Ressources.
Voir aussi
Concepts
Ressources dans les applications
Empaquetage et déploiement de ressources