My.Resources, objet

Article
06/02/2023

Fournit des propriétés et des classes permettant d’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 dynamiquement les ressources de votre application. Pour plus d’informations, consultez Gestion des ressources d’une application (.NET).

L’objet My.Resources expose uniquement les ressources globales. Il ne fournit pas l’accès aux fichiers de ressources associés aux formulaires. Vous devez accéder aux ressources de formulaire à partir du formulaire.

Vous pouvez accéder aux fichiers de ressources spécifiques à la culture de l’application à partir de l’objet My.Resources. Par défaut, l’objet My.Resources recherche des ressources à partir du fichier de ressources qui correspond à la culture de la propriété UICulture. Toutefois, vous pouvez écraser ce comportement et spécifier une culture particulière pour les ressources. Pour plus d’informations, consultez Ressources dans les applications .NET.

Propriétés

Les propriétés de l’objet My.Resources fournissent l’accès en lecture seule aux ressources de votre application. Pour ajouter ou supprimer des ressources, utilisez le Concepteur de projets. Vous pouvez accéder aux ressources ajoutées via le 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 Ajouter un élément existant dans le menu Projet. Vous pouvez accéder aux ressources ajoutées de cette manière à l’aide de My.Resources.resourceFileName.resourceName.

Chaque ressource a un nom, une catégorie et une valeur. Ces paramètres de ressource déterminent la façon dont la propriété d’accès à la ressource apparaît 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 ressource correspondent à la valeur de la propriété.
La catégorie détermine le type de la propriété :

Category	Type de données de propriété
Chaînes	Chaîne
Images	Bitmap
Icônes	Icon
Audio	UnmanagedMemoryStream La classe UnmanagedMemoryStream dérive de la classe Stream. Elle peut donc être utilisée avec des méthodes qui prennent des flux, comme la méthode Play.
Fichiers	- Chaîne pour les fichiers texte. - Bitmap pour les fichiers d’images. - Icon pour les fichiers d’icônes. - 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 en tant que classe avec des propriétés partagées. Le nom de la classe est identique au nom du fichier de ressources. Comme décrit dans la section précédente, les ressources d’un fichier de ressources sont exposées en tant que propriétés dans la classe.

Exemple 1

Cet exemple définit le titre d’un formulaire sur la ressource de chaîne nommée Form1Title dans le fichier de ressources de l’application. Pour que l’exemple fonctionne, le fichier de ressources de l’application doit comprendre une chaîne nommée Form1Title.

Sub SetFormTitle()
    Me.Text = My.Resources.Form1Title
End Sub

Exemple 2

Cet exemple définit l’icône du formulaire sur l’icône nommée Form1Icon qui est stockée dans le fichier de ressources de l’application. Pour que l’exemple fonctionne, le fichier de ressources de l’application doit comprendre une icône nommée Form1Icon.

Sub SetFormIcon()
    Me.Icon = My.Resources.Form1Icon
End Sub

Exemple 3

Cet exemple définit l’image d’arrière-plan d’un formulaire sur la ressource d’image nommée Form1Background, qui se trouve dans le fichier de ressources de l’application. Pour que cet exemple fonctionne, le fichier de ressources de l’application doit comprendre une ressource d’image nommée Form1Background.

Sub SetFormBackgroundImage()
    Me.BackgroundImage = My.Resources.Form1Background
End Sub

Exemple 4

Cet exemple lit le son stocké en tant que ressource audio nommée Form1Greeting dans le fichier de ressources de l’application. Pour que l’exemple fonctionne, le fichier de ressources de l’application doit comprendre une ressource audio nommée Form1Greeting. La méthode My.Computer.Audio.Play est disponible uniquement pour les applications Windows Forms.

Sub PlayFormGreeting()
    My.Computer.Audio.Play(My.Resources.Form1Greeting, 
        AudioPlayMode.Background)
End Sub

Exemple 5

Cet exemple récupère la version de culture Français d’une ressource de chaîne de l’application. La ressource est nommée Message. Pour modifier la culture utilisée par l’objet My.Resources, l’exemple utilise ChangeUICulture.

Pour que cet exemple fonctionne, le fichier de ressources de l’application doit comporter une chaîne nommée Message et l’application doit disposer de la version de culture Français de ce fichier de ressources (Resources.fr-FR.resx). Si l’application ne dispose pas de la version de culture Français du fichier de ressources, l’objet My.Resource récupère la ressource à partir du fichier de ressources de culture par défaut.

Sub ShowLocalizedMessage()
    Dim culture As String = My.Application.UICulture.Name
    My.Application.ChangeUICulture("fr-FR")
    MsgBox(My.Resources.Message)
    My.Application.ChangeUICulture(culture)
End Sub