Objeto My.Resources

Fornece propriedades e classes para acessar os recursos do aplicativo.

Observações

O My.Resources objeto fornece acesso aos recursos do aplicativo e permite recuperar dinamicamente recursos para seu aplicativo. Para obter mais informações, consulte Gerenciamento de Recursos de Aplicativo (.NET).

O My.Resources objeto expõe apenas recursos globais. Ele não fornece acesso aos arquivos de recursos associados aos formulários. Você deve acessar os recursos de formulário do formulário.

Você pode acessar os arquivos de recurso específicos da cultura do aplicativo do My.Resources objeto. Por padrão, o My.Resources objeto pesquisa recursos do arquivo de recurso que corresponde à cultura na UICulture propriedade. No entanto, você pode substituir esse comportamento e especificar uma cultura específica a ser usada para os recursos. Para obter mais informações, consulte Recursos em aplicativos .NET.

Propriedades

As propriedades do My.Resources objeto fornecem acesso somente leitura aos recursos do aplicativo. Para adicionar ou remover recursos, use o Designer de Projeto. Você pode acessar os recursos adicionados por meio do Designer de Projeto usando My.Resources.resourceName.

Você também pode adicionar ou remover arquivos de recursos selecionando seu projeto no Gerenciador de Soluções e clicando em Adicionar Novo Item ou Adicionar Item Existente no menu Projeto . Você pode acessar os recursos adicionados dessa maneira usando My.Resources.resourceFileNameresourceName..

Cada recurso tem um nome, categoria e valor, e essas configurações de recurso determinam como a propriedade para acessar o recurso aparece no My.Resources objeto. Para recursos adicionados no Designer de Projeto:

• O nome determina o nome da propriedade,

• Os dados do recurso são o valor da propriedade,

• A categoria determina o tipo da propriedade:

Categoria	Tipo de dados de propriedade
Cadeias de caracteres	String
Imagens	Bitmap
Ícones	Icon
Áudio	UnmanagedMemoryStream A UnmanagedMemoryStream classe deriva da Stream classe, para que possa ser usada com métodos que levam fluxos, como o Play método.
Arquivos	- Cadeia de caracteres para arquivos de texto. - Bitmap para arquivos de imagem. - Icon para arquivos de ícone. - UnmanagedMemoryStream para arquivos de som.
Outras	Determinado pelas informações na coluna Tipo do designer.

Aulas

O My.Resources objeto expõe cada arquivo de recurso como uma classe com propriedades compartilhadas. O nome da classe é o mesmo que o nome do arquivo de recurso. Conforme descrito na seção anterior, os recursos em um arquivo de recurso são expostos como propriedades na classe.

Exemplo 1

Este exemplo define o título de um formulário para o recurso de cadeia de caracteres nomeado Form1Title no arquivo de recurso do aplicativo. Para que o exemplo funcione, o aplicativo deve ter uma cadeia de caracteres nomeada Form1Title em seu arquivo de recurso.

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

Exemplo 2

Este exemplo define o ícone do formulário como o ícone nomeado Form1Icon que é armazenado no arquivo de recurso do aplicativo. Para que o exemplo funcione, o aplicativo deve ter um ícone nomeado Form1Icon em seu arquivo de recurso.

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

Exemplo 3

Este exemplo define a imagem de plano de fundo de um formulário para o recurso de imagem chamado Form1Background, que está no arquivo de recurso do aplicativo. Para que este exemplo funcione, o aplicativo deve ter um recurso de imagem nomeado Form1Background em seu arquivo de recurso.

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

Exemplo 4

Este exemplo reproduz o som armazenado como um recurso de áudio nomeado Form1Greeting no arquivo de recurso do aplicativo. Para que o exemplo funcione, o aplicativo deve ter um recurso de áudio nomeado Form1Greeting em seu arquivo de recurso. O My.Computer.Audio.Play método está disponível apenas para aplicativos do Windows Forms.

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

Exemplo 5

Este exemplo recupera a versão da cultura francesa de um recurso de cadeia de caracteres do aplicativo. O recurso é nomeado Message. Para alterar a cultura que o My.Resources objeto usa, o exemplo usa ChangeUICulture.

Para que este exemplo funcione, o aplicativo deve ter uma cadeia de caracteres nomeada Message em seu arquivo de recurso e o aplicativo deve ter a versão de cultura francesa desse arquivo de recurso, Recursos.fr-FR.resx. Se o aplicativo não tiver a versão de cultura francesa do arquivo de recurso, o My.Resource objeto recuperará o recurso do arquivo de recurso de cultura padrão.

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 também

• Gerenciando recursos de aplicativo (.NET)
• Recursos em aplicativos .NET