Objeto My.Resources

Artigo
05/10/2023

Fornece propriedades e classes para acessar recursos do aplicativo.

Comentários

O objeto My.Resources fornece acesso aos recursos do aplicativo e permite que você recupere recursos dinamicamente para o aplicativo. Para obter mais informações, consulte Gerenciando recursos de aplicativo (.NET).

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

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

Propriedades

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

Você também pode adicionar ou remover arquivos de recursos selecionando o projeto no Gerenciador de Soluções e clicando em Adicionar novo item ou Adicionar item existente no menu Projeto. Você pode acessar recursos adicionados dessa maneira usando My.Resources.resourceFileName.resourceName.

Cada recurso tem um nome, categoria e valor, e essas configurações de recurso determinam como a propriedade para acessar o recurso aparece no objeto My.Resources. 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	Cadeia de caracteres
Imagens	Bitmap
Ícones	Icon
Áudio	UnmanagedMemoryStream A classe UnmanagedMemoryStream deriva de Stream, de modo que pode ser usada com métodos que fazem fluxos, como o método Play.
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.

Classes

O objeto My.Resources expõe cada arquivo de recurso como uma classe com propriedades compartilhadas. O nome da classe é igual ao 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 no arquivo de recurso.

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

Exemplo 2

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

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

Exemplo 3

Este exemplo define a imagem em segundo plano de um formulário para o recurso de imagem nomeado Form1Background, que está no arquivo de recurso do aplicativo. Para que o exemplo funcione, o aplicativo deve ter um recurso de imagem nomeado Form1Background no 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 no arquivo de recurso. O método My.Computer.Audio.Play 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 de cultura francesa de um recurso de cadeia de caracteres do aplicativo. O recurso é nomeado Message. Para alterar a cultura que o objeto My.Resources usa, o exemplo usa ChangeUICulture.

Para que este exemplo funcione, o aplicativo deve ter uma cadeia de caracteres nomeada Message no arquivo de recurso e o aplicativo deve ter a versão de cultura francesa desse arquivo de recurso, Resources.fr-FR.resx. Se o aplicativo não tiver a versão de cultura francesa do arquivo de recurso, o objeto My.Resource 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

Compartilhar via