My.Resources (objeto)

Proporciona propiedades y clases para acceder a los recursos de la aplicación.

Observaciones

El My.Resources objeto proporciona acceso a los recursos de la aplicación y le permite recuperar recursos de forma dinámica para la aplicación. Para obtener más información, consulte Administración de recursos de aplicación (.NET).

El My.Resources objeto expone solo los recursos globales. No proporciona acceso a los archivos de recursos asociados a formularios. Debe acceder a los recursos del formulario desde el formulario.

Puede acceder a los archivos de recursos específicos de la referencia cultural de la aplicación desde el My.Resources objeto . De forma predeterminada, el My.Resources objeto busca recursos del archivo de recursos que coincide con la referencia cultural de la UICulture propiedad . Sin embargo, puede invalidar este comportamiento y especificar una referencia cultural determinada que se usará para los recursos. Para obtener más información, consulte Recursos en aplicaciones .NET.

Propiedades

Las propiedades del My.Resources objeto proporcionan acceso de solo lectura a los recursos de la aplicación. Para agregar o quitar recursos, use el Diseñador de proyectos. Puede acceder a los recursos agregados a través del Diseñador de proyectos mediante My.Resources.resourceName.

También puede agregar o quitar archivos de recursos seleccionando el proyecto en el Explorador de soluciones y haciendo clic en Agregar nuevo elemento o Agregar elemento existente en el menú Proyecto . Puede acceder a los recursos agregados de esta manera mediante My.Resources.resourceFileName.resourceName.

Cada recurso tiene un nombre, una categoría y un valor, y esta configuración de recursos determina cómo aparece la propiedad para acceder al recurso en el My.Resources objeto . Para los recursos agregados en el Diseñador de proyectos:

• El nombre determina el nombre de la propiedad ,

• Los datos del recurso son el valor de la propiedad ,

• La categoría determina el tipo de la propiedad :

Categoría	Tipo de datos de propiedad
Cadenas	String
imágenes	Bitmap
iconos	Icon
Audio	UnmanagedMemoryStream La UnmanagedMemoryStream clase deriva de la Stream clase , por lo que se puede usar con métodos que toman secuencias, como el Play método .
Archivos	- Cadena para archivos de texto. - Bitmap para archivos de imagen. - Icon para archivos de icono. - UnmanagedMemoryStream para archivos de sonido.
Otros	Determinada por la información de la columna Tipo del diseñador.

Las clases

El My.Resources objeto expone cada archivo de recursos como una clase con propiedades compartidas. El nombre de clase es el mismo que el nombre del archivo de recursos. Como se describe en la sección anterior, los recursos de un archivo de recursos se exponen como propiedades en la clase .

Ejemplo 1

En este ejemplo se establece el título de un formulario en el recurso de cadena denominado Form1Title en el archivo de recursos de la aplicación. Para que el ejemplo funcione, la aplicación debe tener una cadena denominada Form1Title en su archivo de recursos.

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

Ejemplo 2

En este ejemplo se establece el icono del formulario en el icono denominado Form1Icon que se almacena en el archivo de recursos de la aplicación. Para que el ejemplo funcione, la aplicación debe tener un icono denominado Form1Icon en su archivo de recursos.

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

Ejemplo 3

En este ejemplo se establece la imagen de fondo de un formulario en el recurso de imagen denominado Form1Background, que se encuentra en el archivo de recursos de la aplicación. Para que este ejemplo funcione, la aplicación debe tener un recurso de imagen denominado Form1Background en su archivo de recursos.

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

Ejemplo 4

En este ejemplo se reproduce el sonido almacenado como un recurso de audio denominado Form1Greeting en el archivo de recursos de la aplicación. Para que el ejemplo funcione, la aplicación debe tener un recurso de audio denominado Form1Greeting en su archivo de recursos. El My.Computer.Audio.Play método solo está disponible para las aplicaciones de Windows Forms.

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

Ejemplo 5

En este ejemplo se recupera la versión de referencia cultural francesa de un recurso de cadena de la aplicación. El recurso se denomina Message. Para cambiar la referencia cultural que usa el My.Resources objeto, en el ejemplo se usa ChangeUICulture.

Para que este ejemplo funcione, la aplicación debe tener una cadena denominada Message en su archivo de recursos y la aplicación debe tener la versión de referencia cultural francesa de ese archivo de recursos, Resources.fr-FR.resx. Si la aplicación no tiene la versión de referencia cultural francesa del archivo de recursos, el My.Resource objeto recupera el recurso del archivo de recursos de referencia cultural predeterminada.

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

Consulte también

• Administración de recursos de aplicación (.NET)
• Recursos en aplicaciones .NET