Objet My.Resources (Visual Basic)

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 des ressources globales. Il ne fournit pas l'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 propriété UICulture. 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 méthode Play.

Fichiers

Autre

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 d'image

Comment : récupérer des ressources image dans Visual Basic

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

Comment : récupérer des ressources audio dans Visual Basic

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 avoir 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

Autres ressources

Gestion des ressources de l'application