Объект My.Resources

Статья
03/12/2024

Предоставляет свойства и классы для доступа к ресурсам приложения.

Замечания

Объект My.Resources предоставляет доступ к ресурсам приложения и позволяет динамически извлекать ресурсы для приложения. Дополнительные сведения см. в разделе "Управление ресурсами приложений( .NET)".

Объект My.Resources предоставляет только глобальные ресурсы. Он не предоставляет доступ к файлам ресурсов, связанным с формами. Вам нужно получить доступ к ресурсам формы из формы.

Вы можете получить доступ к файлам ресурсов, зависящим от языка и региональных параметров приложения, из My.Resources объекта. По умолчанию My.Resources объект ищет ресурсы из файла ресурсов, соответствующего языку и региональным параметрам в свойстве UICulture . Однако вы можете переопределить это поведение и указать определенный язык и региональные параметры, используемые для ресурсов. Дополнительные сведения см. в разделе Ресурсы в приложениях .NET.

Свойства

Свойства My.Resources объекта предоставляют доступ только для чтения к ресурсам приложения. Чтобы добавить или удалить ресурсы, используйте конструктор проектов. Доступ к ресурсам, добавленным через конструктор проектов, можно получить с помощью My.Resources.resourceName.

Вы также можете добавить или удалить файлы ресурсов, выбрав проект в Обозреватель решений и нажав кнопку "Добавить новый элемент" или "Добавить существующий элемент" в меню "Проект". Вы можете получить доступ к ресурсам, добавленным таким образом, с помощью My.Resources.resourceFileName resourceName..

Каждый ресурс имеет имя, категорию и значение, а эти параметры ресурсов определяют, как свойство для доступа к ресурсу отображается в объекте My.Resources . Для ресурсов, добавленных в конструктор проектов, выполните следующие действия.

Имя определяет имя свойства,
Данные ресурса — это значение свойства,
Категория определяет тип свойства:

Категория	Тип данных свойства
Строки	String
Изображения	Bitmap
Значки	Icon
Звук:	UnmanagedMemoryStream Класс UnmanagedMemoryStream является производным от Stream класса, поэтому его можно использовать с методами, которые принимают потоки, например Play метод.
Файлы	- Строка для текстовых файлов. - Bitmap для файлов изображений. - Icon для файлов значков. - UnmanagedMemoryStream для звуковых файлов.
Другое	Определяется сведениями в столбце типа конструктора.

Классы

Объект My.Resources предоставляет каждый файл ресурса в качестве класса с общими свойствами. Имя класса совпадает с именем файла ресурса. Как описано в предыдущем разделе, ресурсы в файле ресурсов предоставляются как свойства в классе.

Пример 1

В этом примере задается заголовок формы строковым ресурсом с именем Form1Title в файле ресурсов приложения. Для работы примера приложение должно иметь строку с именем Form1Title в файле ресурса.

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

Пример 2

В этом примере значок формы устанавливается на значок с именем Form1Icon , хранящимся в файле ресурсов приложения. Для работы примера приложение должно иметь значок с именем Form1Icon в файле ресурса.

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

Пример 3

В этом примере создается фоновое изображение формы с именем Form1Backgroundресурса изображения, который находится в файле ресурса приложения. В этом примере для работы приложение должно иметь ресурс изображения с именем Form1Background в файле ресурса.

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

Пример 4

В этом примере воспроизводится звук, хранящийся в виде звукового ресурса с именем Form1Greeting в файле ресурсов приложения. Для работы примера приложение должно иметь звуковой ресурс с именем Form1Greeting в файле ресурса. Этот My.Computer.Audio.Play метод доступен только для приложений Windows Forms.

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

Пример 5

В этом примере извлекается версия французского языка и региональных параметров строкового ресурса приложения. Ресурс называется Message. Чтобы изменить язык и региональные параметры, которые My.Resources использует объект, в примере используется ChangeUICulture.

Для работы в этом примере приложение должно иметь строку с именем Message в файле ресурсов, а приложение должно иметь версию этого файла ресурсов, resource.fr-FR.resx. Если у приложения нет версии файла ресурсов французского языка и региональных параметров, My.Resource объект извлекает ресурс из файла ресурсов по умолчанию и региональных параметров.

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