My.Resources, objet
Mise à jour : novembre 2007
Fournit des propriétés et des classes pour accéder aux ressources de l'application.
Notes
L'objet My.Resources fournit l'accès aux ressources de l'application et vous permet de récupérer de manière dynamique des ressources pour votre application. Pour plus d'informations, consultez Gestion des ressources de l'application.
L'objet My.Resources expose uniquement les ressources globales. Il ne fournit pas un accès aux fichiers de ressources associés aux formulaires. Vous devez accéder aux ressources du formulaire à partir du formulaire. Pour plus d'informations, consultez Procédure pas à pas : localisation de Windows Forms.
Vous pouvez accéder aux fichiers de ressources propres à la culture de l'application à partir de l'objet My.Resources. Par défaut, l'objet My.Resources recherche des ressources dans le fichier de ressources correspondant à la culture dans la My.Application.UICulture, propriété. Toutefois, vous pouvez substituer ce comportement et spécifier une culture particulière à utiliser pour les ressources. Pour plus d'informations, consultez Ressources dans les applications.
Propriétés
Les propriétés de l'objet My.Resources fournissent un accès en lecture seule aux ressources de votre application. Pour ajouter ou supprimer des ressources, utilisez le Concepteur de projets. Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources. Vous pouvez accéder aux ressources ajoutées par l'intermédiaire du Concepteur de projets à l'aide de My.Resources.resourceName.
Vous pouvez également ajouter ou supprimer des fichiers de ressources en sélectionnant votre projet dans l'Explorateur de solutions et en cliquant sur Ajouter un nouvel élément ou sur Ajouter un élément existant dans le menu Projet. Vous pouvez accéder aux ressources ajoutées de cette manière en utilisant My.Resources.resourceFileName.resourceName.
Chaque ressource a un nom, une catégorie et une valeur, et ces paramètres de ressources déterminent l'affichage de la propriété qui accède à la ressource dans l'objet My.Resources. Pour les ressources ajoutées dans le Concepteur de projets :
Le nom détermine le nom de la propriété,
Les données de ressources représentent la valeur de la propriété,
La catégorie détermine le type de la propriété :
Catégorie
Type de données de la propriété
Chaînes
Images
Icônes
Audio
La classe UnmanagedMemoryStream dérivant de la classe Stream, elle peut être utilisée avec les méthodes qui acceptent les flux, par exemple la My.Computer.Audio.Play, méthode.
Fichiers
String pour les fichiers texte.
Bitmap pour les fichiers image.
Icon pour les fichiers icône.
UnmanagedMemoryStream pour les fichiers audio.
Autres
Déterminé par les informations contenues dans la colonne Type du concepteur.
Classes
L'objet My.Resources expose chaque fichier de ressources comme une classe contenant des propriétés partagées. Le nom de la classe est identique à celui du fichier de ressources. Comme indiqué dans la section précédente, les ressources contenues dans un fichier de ressources sont exposées comme des propriétés de la classe.
Tâches
Le tableau suivant répertorie des exemples de tâches impliquant l'objet My.Resources.
Pour |
Consultez |
---|---|
Récupérer une ressource de type chaîne |
Comment : récupérer des ressources de type chaîne dans Visual Basic |
Récupérer une ressource image |
|
Récupérer une ressource icône |
Comment : récupérer des ressources de type icône dans Visual Basic |
Récupérer une ressource audio |
|
Récupérer une ressource localisée |
Comment : récupérer des ressources localisées dans Visual Basic |
Exemple
Cet exemple affecte à l'icône du formulaire l'icône nommée Form1Icon qui est enregistrée dans le fichier de ressources de l'application.
Sub SetFormIcon()
Me.Icon = My.Resources.Form1Icon
End Sub
Pour que cet exemple fonctionne, votre application doit contenir une icône nommée Form1Icon dans le fichier de ressources de l'application. Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources.
Voir aussi
Tâches
Comment : récupérer des ressources de type chaîne dans Visual Basic
Comment : récupérer des ressources image dans Visual Basic
Comment : récupérer des ressources de type icône dans Visual Basic
Comment : récupérer des ressources audio dans Visual Basic
Comment : récupérer des ressources localisées dans Visual Basic
Comment : ajouter ou supprimer des ressources
Procédure pas à pas : localisation de Windows Forms
Concepts
Ressources dans les applications
Référence
My.Application.UICulture, propriété