Объект 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

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

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

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

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