My.Resources (Objeto)My.Resources Object

Proporciona propiedades y clases para tener acceso a recursos de la aplicación.Provides properties and classes for accessing the application's resources.

ComentariosRemarks

La My.Resources objeto proporciona acceso a recursos de la aplicación y le permite dinámicamente recupere los recursos de la aplicación.The My.Resources object provides access to the application's resources and lets you dynamically retrieve resources for your application. Para obtener más información, consulte administrar aplicación de recursos (. NET).For more information, see Managing Application Resources (.NET).

La My.Resources objeto expone sólo recursos globales.The My.Resources object exposes only global resources. No proporciona acceso a los archivos de recursos asociados con los formularios.It does not provide access to resource files associated with forms. Debe tener acceso a los recursos de formulario desde el formulario.You must access the form resources from the form.

Puede tener acceso a archivos de recursos específicos de la referencia cultural de la aplicación desde el My.Resources objeto.You can access the application's culture-specific resource files from the My.Resources object. De forma predeterminada, el My.Resources objeto busca recursos en el archivo de recursos que coincida con la referencia cultural en el UICulture propiedad.By default, the My.Resources object looks up resources from the resource file that matches the culture in the UICulture property. Sin embargo, puede invalidar este comportamiento y especificar una determinada referencia cultural que se usará para los recursos.However, you can override this behavior and specify a particular culture to use for the resources. Para obtener más información, vea Resources in Desktop Apps (Recursos de aplicaciones de escritorio).For more information, see Resources in Desktop Apps.

PropiedadesProperties

Las propiedades de la My.Resources objeto proporcionar acceso de solo lectura a los recursos de la aplicación.The properties of the My.Resources object provide read-only access to your application's resources. Para agregar o quitar recursos, utilice el Diseñador de proyectos.To add or remove resources, use the Project Designer. Puede obtener acceso a los recursos agregados a través de la Diseñador de proyectos utilizando My.Resources. resourceName.You can access resources added through the Project Designer by using My.Resources.resourceName.

También puede agregar o quitar archivos de recursos, seleccione el proyecto en el Explorador de soluciones y haga clic en Agregar nuevo elemento o Agregar elemento existente desde el Proyecto menú.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. Puede obtener acceso a los recursos agregados de esta manera mediante My.Resources. NombreArchivoRecursos.resourceName.You can access resources added in this manner by using My.Resources.resourceFileName.resourceName.

Cada recurso tiene un nombre, categoría y valor, y esta configuración de recursos determina cómo aparece en la propiedad para tener acceso al recurso el My.Resources objeto.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. Para los recursos que agregó en el Diseñador de proyectos:For resources added in the Project Designer:

  • El nombre determina el nombre de la propiedad,The name determines the name of the property,

  • Los datos de recursos están el valor de la propiedad,The resource data is the value of the property,

  • La categoría determina el tipo de la propiedad:The category determines the type of the property:

CategoríaCategory Propiedad tipo de datosProperty data type
CadenasStrings StringString
ImágenesImages Bitmap
IconosIcons Icon
AudioAudio UnmanagedMemoryStream

El UnmanagedMemoryStream clase se deriva de la Stream clase, por lo que puede usarse con métodos que toman secuencias, como el Play método.The UnmanagedMemoryStream class derives from the Stream class, so it can be used with methods that take streams, such as the Play method.
ArchivosFiles - Cadena para archivos de texto.- String for text files.
- Bitmap para los archivos de imagen.- Bitmap for image files.
- Icon para los archivos de icono.- Icon for icon files.
- UnmanagedMemoryStream para los archivos de sonido.- UnmanagedMemoryStream for sound files.
Otros problemasOther Determinado por la información en el diseñador tipo columna.Determined by the information in the designer's Type column.

ClasesClasses

La My.Resources objeto expone cada archivo de recursos como una clase con propiedades compartidas.The My.Resources object exposes each resource file as a class with shared properties. El nombre de clase es el mismo que el nombre del archivo de recursos.The class name is the same as the name of the resource file. Como se describe en la sección anterior, los recursos en un archivo de recursos se exponen como propiedades en la clase.As described in the previous section, the resources in a resource file are exposed as properties in the class.

EjemploExample

Este ejemplo establece el título de un formulario en el recurso de cadena denominado Form1Title en el archivo de recursos de la aplicación.This example sets the title of a form to the string resource named Form1Title in the application resource file. Para que funcione el ejemplo, la aplicación debe tener una cadena denominada Form1Title en su archivo de recursos.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

EjemploExample

Este ejemplo establece el icono del formulario en el icono denominado Form1Icon que se almacena en el archivo de recursos de la aplicación.This example sets the icon of the form to the icon named Form1Icon that is stored in the application's resource file. Para que funcione el ejemplo, la aplicación debe tener un icono denominado Form1Icon en su archivo de recursos.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

EjemploExample

Este ejemplo 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.This example sets the background image of a form to the image resource named Form1Background, which is in the application resource file. Para que funcione este ejemplo, la aplicación debe tener un recurso de imagen denominado Form1Background en su archivo de recursos.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

EjemploExample

Este ejemplo reproduce el sonido que se almacena como un recurso de sonido denominado Form1Greeting en el archivo de recursos de la aplicación.This example plays the sound that is stored as an audio resource named Form1Greeting in the application's resource file. Para que funcione el ejemplo, la aplicación debe tener un recurso de sonido denominado Form1Greeting en su archivo de recursos.For the example to work, the application must have an audio resource named Form1Greeting in its resource file. El My.Computer.Audio.Play método solo está disponible para las aplicaciones de 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

EjemploExample

Este ejemplo recupera la versión de la referencia cultural de francés de un recurso de cadena de la aplicación.This example retrieves the French-culture version of a string resource of the application. El recurso se denomina Message.The resource is named Message. Para cambiar la referencia cultural que la My.Resources objeto, el ejemplo utiliza ChangeUICulture.To change the culture that the My.Resources object uses, the example uses ChangeUICulture.

Para que funcione este ejemplo, la aplicación debe tener una cadena denominada Message en su recurso de archivo y la aplicación deben tener la versión de la referencia cultural de francés de ese archivo de recursos, 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. Si la aplicación no tiene la versión de la referencia cultural de francés del archivo de recursos, la My.Resource objeto recupera el recurso desde el archivo de recursos de la referencia cultural predeterminada.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

Vea tambiénSee also