Объект My.Resources

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

Заметки

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

Объект My.Resources предоставляет только глобальные ресурсы. Он не обеспечивает доступа к файлам ресурсов, связанных с формами. К ресурсам формы необходимо получать доступ из формы. Дополнительные сведения см. в разделе Пошаговое руководство. Локализация форм Windows Forms.

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

Свойства

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

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

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

• Имя определяет имя свойства.

• Данные ресурсов являются значением свойства,

• Категория определяет тип свойства.

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

Классы

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

Пример

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

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

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

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

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

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

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

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

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

Для работы этого примера необходимо, чтобы приложение должно иметь строки Message в файле ресурсов и приложении иметь версию Французск-языка и региональные параметры этого файла ресурсов, Resources.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

См. также

Задачи

Пошаговое руководство. Локализация форм Windows Forms

Основные понятия

Ресурсы в приложениях для настольных систем

Другие ресурсы

Практическое руководство. Добавление или удаление ресурсов

Управление ресурсами приложения