Objeto My.Resources

Artigo
03/13/2024

Fornece propriedades e classes para acessar os recursos do aplicativo.

Observações

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

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

Você pode acessar os arquivos de recursos específicos da cultura do aplicativo a partir do My.Resources objeto. Por padrão, o My.Resources objeto procura recursos do arquivo de recurso que corresponde à UICulture cultura na 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 seu aplicativo. Para adicionar ou remover recursos, use o Project Designer. Você pode acessar recursos adicionados por meio do Project Designer 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 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 My.Resources objeto. Para recursos adicionados no Project Designer:

O nome determina o nome da propriedade,
Os dados do recurso são o valor da propriedade,
A categoria determina o tipo de propriedade:

Categoria	Tipo de dados de propriedade
Cordas	Cadeia
Imagens	Bitmap
Ícones	Icon
Áudio	UnmanagedMemoryStream A UnmanagedMemoryStream classe deriva da Stream classe, portanto, pode ser usada com métodos que tomam fluxos, como o Play método.
Ficheiros	- String para arquivos de texto. - Bitmap para arquivos de imagem. - Icon para arquivos de ícones. - UnmanagedMemoryStream para ficheiros de som.
Outro	Determinado pelas informações na coluna Tipo do designer.

Classes

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 como 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 chamado 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 como 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 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 é chamado 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, Resources.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

Partilhar via