My.Resources, objet

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 des applications de bureau.

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	Chaîne
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	String pour les fichiers texte. Bitmap pour les fichiers image. Icon pour les fichiers icône. UnmanagedMemoryStream pour les fichiers audio.
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.

Exemple

Cet exemple définit le titre d'un formulaire la ressource de type chaîne nommée Form1Title dans le fichier de ressources de l'application.Pour que l'exemple fonctionne, l'application doit avoir une chaîne nommée Form1Title dans son fichier de ressources.Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources.

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

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.Pour que l'exemple fonctionne, l'application doit avoir une icône nommée Form1Icon dans son fichier de ressources.

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

Cet exemple affecte l'image d'arrière-plan d'un formulaire à la ressource d'image nommée Form1Background, qui se trouve dans le fichier de ressources de l'application.Pour que cet exemple fonctionne, l'application doit avoir une ressource d'image nommée Form1Background dans son fichier de ressources.

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

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

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

Cet exemple récupère la version de culture française d'une ressource de type chaîne de l'application.la ressource est nommée Message.pour modifier la culture que les utilisations d'objet d' My.Resources , l'exemple utilise ChangeUICulture.

Pour que cet exemple fonctionne, l'application doit avoir une chaîne nommée Message dans son fichier de ressources, et l'application doit utiliser la version de culture française de ce fichier de ressources, Resources.fr-FR.resx.Pour plus d'informations, consultez Comment : ajouter ou supprimer des ressources.Si l'application n'a pas la version de culture française du fichier de ressources, l'objet d' My.Resource récupère la ressource du fichier de ressources de la 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

Voir aussi

Tâches

Comment : ajouter ou supprimer des ressources

Procédure pas à pas : localisation de Windows Forms

Concepts

Ressources dans des applications de bureau

Autres ressources

Gestion des ressources de l'application