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	String
  Images	Bitmap
  Icônes	Icon
  Audio	UnmanagedMemoryStream 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.

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é

Autres ressources

Gestion des ressources de l'application