Объект My.ResourcesMy.Resources Object

Предоставляет свойства и классы для доступа к ресурсам приложения.Provides properties and classes for accessing the application's resources.

RemarksRemarks

My.ResourcesОбъект предоставляет доступ к ресурсам приложения и позволяет динамически получать ресурсы для приложения.The My.Resources object provides access to the application's resources and lets you dynamically retrieve resources for your application. Дополнительные сведения см. в разделе Управление ресурсами приложения (.NET).For more information, see Managing Application Resources (.NET).

Объект My.Resources предоставляет только глобальные ресурсы.The My.Resources object exposes only global resources. Он не предоставляет доступ к файлам ресурсов, связанным с формами.It does not provide access to resource files associated with forms. Вам нужно получить доступ к ресурсам формы из формы.You must access the form resources from the form.

Доступ к файлам ресурсов для конкретного языка и региональных параметров приложения можно получить из My.Resources объекта.You can access the application's culture-specific resource files from the My.Resources object. По умолчанию My.Resources объект ищет ресурсы из файла ресурсов, соответствующие языку и региональным параметрам в UICulture свойстве.By default, the My.Resources object looks up resources from the resource file that matches the culture in the UICulture property. Однако это поведение можно переопределить и указать конкретный язык и региональные параметры, которые будут использоваться для ресурсов.However, you can override this behavior and specify a particular culture to use for the resources. Дополнительные сведения см. в разделе Ресурсы в приложениях для настольных систем.For more information, see Resources in Desktop Apps.

СвойстваProperties

Свойства My.Resources объекта предоставляют доступ только для чтения к ресурсам приложения.The properties of the My.Resources object provide read-only access to your application's resources. Чтобы добавить или удалить ресурсы, используйте Конструктор проектов.To add or remove resources, use the Project Designer. Доступ к ресурсам, добавленным с помощью конструктора проектов , можно получить с помощью My.Resources. resourceName.You can access resources added through the Project Designer by using My.Resources.resourceName.

Можно также добавлять или удалять файлы ресурсов, выбрав проект в Обозреватель решений и выбрав пункт Добавить новый элемент или Добавить существующий элемент в меню проект .You can also add or remove resource files by selecting your project in Solution Explorer and clicking Add New Item or Add Existing Item from the Project menu. Доступ к ресурсам, добавленным таким способом, можно получить с помощью My.Resources. ресаурцефиленаме . resourceName.You can access resources added in this manner by using My.Resources.resourceFileName.resourceName.

Каждый ресурс имеет имя, категорию и значение, и эти параметры ресурсов определяют, как свойство для доступа к ресурсу отображается в My.Resources объекте.Each resource has a name, category, and value, and these resource settings determine how the property to access the resource appears in the My.Resources object. Для ресурсов, добавленных в конструкторе проектов:For resources added in the Project Designer:

  • Имя определяет имя свойства,The name determines the name of the property,

  • Данные ресурса являются значением свойства,The resource data is the value of the property,

  • Категория определяет тип свойства:The category determines the type of the property:

КатегорияCategory Тип данных свойстваProperty data type
СтрокиStrings StringString
ИзображенияImages Bitmap
ЗначкиIcons Icon
звук;Audio UnmanagedMemoryStream

UnmanagedMemoryStreamКласс является производным от Stream класса, поэтому его можно использовать с методами, принимающими потоки, например Play метод.The UnmanagedMemoryStream class derives from the Stream class, so it can be used with methods that take streams, such as the Play method.
ФайлыFiles - Строка для текстовых файлов.- String for text files.
- Bitmap для файлов изображений.- Bitmap for image files.
- Icon для файлов значков.- Icon for icon files.
- UnmanagedMemoryStream для звуковых файлов.- UnmanagedMemoryStream for sound files.
ДругоеOther Определяется сведениями в столбце типа конструктора.Determined by the information in the designer's Type column.

КлассыClasses

My.ResourcesОбъект предоставляет каждый файл ресурсов как класс с общими свойствами.The My.Resources object exposes each resource file as a class with shared properties. Имя класса совпадает с именем файла ресурсов.The class name is the same as the name of the resource file. Как описано в предыдущем разделе, ресурсы в файле ресурсов предоставляются как свойства в классе.As described in the previous section, the resources in a resource file are exposed as properties in the class.

ПримерExample

В этом примере задается заголовок формы в виде строкового ресурса, указанного Form1Title в файле ресурсов приложения.This example sets the title of a form to the string resource named Form1Title in the application resource file. Чтобы пример работал, приложение должно иметь строку с именем Form1Title в файле ресурсов.For the example to work, the application must have a string named Form1Title in its resource file.

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

ПримерExample

В этом примере значок формы задается значком с именем Form1Icon , который хранится в файле ресурсов приложения.This example sets the icon of the form to the icon named Form1Icon that is stored in the application's resource file. Чтобы пример работал, приложение должно иметь Form1Icon в своем файле ресурсов значок с именем.For the example to work, the application must have an icon named Form1Icon in its resource file.

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

ПримерExample

В этом примере для фонового изображения формы задается ресурс изображения с именем Form1Background , который находится в файле ресурсов приложения.This example sets the background image of a form to the image resource named Form1Background, which is in the application resource file. Чтобы этот пример работал, приложение должно иметь ресурс образа с именем Form1Background в файле ресурсов.For this example to work, the application must have an image resource named Form1Background in its resource file.

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

ПримерExample

В этом примере воспроизводится звук, который хранится в виде звукового ресурса Form1Greeting в файле ресурсов приложения.This example plays the sound that is stored as an audio resource named Form1Greeting in the application's resource file. Чтобы пример работал, в файле ресурсов приложения должен быть указан звуковой ресурс Form1Greeting .For the example to work, the application must have an audio resource named Form1Greeting in its resource file. My.Computer.Audio.PlayМетод доступен только для приложений Windows Forms.The My.Computer.Audio.Play method is available only for Windows Forms applications.

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

ПримерExample

В этом примере извлекается версия строкового ресурса приложения на французском языке.This example retrieves the French-culture version of a string resource of the application. Ресурс называется Message .The resource is named Message. Для изменения языка и региональных параметров, My.Resources используемых объектом, в примере используется ChangeUICulture .To change the culture that the My.Resources object uses, the example uses ChangeUICulture.

Для работы этого примера приложение должно иметь строку с именем Message в файле ресурсов, а приложение должно иметь версию файла ресурсов для французского языка и региональных параметров Resources.fr-FR. resx.For this example to work, the application must have a string named Message in its resource file, and the application should have the French-culture version of that resource file, Resources.fr-FR.resx. Если приложение не имеет версию файла ресурсов для французского языка и региональных параметров, My.Resource объект получает ресурс из файла ресурсов языка и региональных параметров по умолчанию.If the application does not have the French-culture version of the resource file, the My.Resource object retrieves the resource from the default-culture resource file.

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

См. такжеSee also