My.Resources (Objeto)
Proporciona propiedades y clases para acceder a los recursos de la aplicación.
Comentarios
El objeto My.Resources proporciona acceso a los recursos de la aplicación y permite recuperar dinámicamente los recursos de la aplicación. Para más información, consulte Administración de los recursos de la aplicación (.NET).
El objeto My.Resources expone solo recursos globales. No da acceso a los archivos de recursos asociados a los formularios. Para acceder a los recursos de formulario, hay que hacerlo desde el formulario.
Puede acceder a los archivos de recursos específicos de la referencia cultural de la aplicación desde el objeto My.Resources. De manera predeterminada, el objeto My.Resources busca recursos del archivo de recursos que coincide con la referencia cultural de la propiedad UICulture. 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 objeto My.Resources proporciona 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 con el Diseñador de proyectos mediante el uso de My.Resources.resourceName.
También puede agregar o quitar archivos de recursos, para lo que debe seleccionar el proyecto en el Explorador de soluciones y hacer clic en Agregar nuevo elemento o Agregar elemento existente desde el menú Proyecto. Puede acceder a los recursos agregados de esta manera mediante el uso de My.Resources.resourceFileName.resourceName.
Cada recurso tiene un nombre, una categoría y un valor, y la configuración de estos recursos determina cómo aparece la propiedad para acceder al recurso en el objeto My.Resources. Para los recursos agregados en el Diseñador de proyectos:
El nombre determina el nombre de la propiedad.
Los datos de recursos son el valor de la propiedad.
La categoría determina el tipo de la propiedad.
| Category | Tipo de datos de la propiedad |
|---|---|
| Cadenas | String |
| Imágenes | Bitmap |
| Iconos | Icon |
| Audio | UnmanagedMemoryStream La clase UnmanagedMemoryStream deriva de la clase Stream, por lo que se puede usar con métodos que toman secuencias, como el método Play. |
| Archivos | - String para archivos de texto. - Bitmap para archivos de imagen. - Icon para archivos de icono. - UnmanagedMemoryStream para archivos de sonido. |
| Otros | Lo determina la información de la columna Type del diseñador. |
Clases
El objeto My.Resources expone cada archivo de recursos como una clase con propiedades compartidas. El nombre de clase es el mismo nombre del archivo de recursos. Como se describió 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 es 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 que se almacena como un recurso de audio denominado Form1Greeting en el archivo de recursos de la aplicación. Para que este ejemplo funcione, la aplicación debe tener un recurso de audio denominado Form1Greeting en su archivo de recursos. El método My.Computer.Audio.Play 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 el objeto My.Resources usa, 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 objeto My.Resource recupera el recurso del archivo de recursos de la 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
