Objeto My.Resources

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ê se recupere dinamicamente recursos para seu aplicativo.Para obter mais informações, consulte Gerenciamento de recursos de aplicativo.

O objeto My.Resources expõe apenas recursos globais.Ele não fornece acesso aos arquivos de recursos associados a formulários.Você deve acessar os recursos de formulário a partir do formulário.Para obter mais informações, consulte Passo a passo: Localizando Windows Forms.

Você pode acessar arquivos de recurso com cultura específica do aplicativo a partir do objeto My.Resources.Por padrão, o My.Resources objeto procura de recursos que coincida com a cultura no arquivo de recurso a UICulture propriedade.No entanto, você pode substituir esse comportamento e especificar uma cultura específica para usar os recursos.Para obter mais informações, consulte Recursos em aplicativos de Desktop.

Propriedades

As propriedades da My.Resources objeto fornecer acesso somente leitura para recursos de seu aplicativo.Para adicionar ou remover recursos, use o Project Designer.Para obter mais informações, consulte Como: Adicionar ou remover recursos.Você pode acessar recursos adicionados por meio do Project Designer usando My.Resources.resourceName.

Você também pode adicionar ou remover os arquivos de recurso, selecionando o seu projeto no Gerenciador de Soluções e clicando em Adicionar Novo Item ou Adicionar Item Existente a partir do 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 na caixa Projeto Designer :

• O nome determina o nome da propriedade,

• Os dados de recursos é o valor da propriedade,

• A categoria determina o tipo da propriedade:

<strong>Categoria</strong>	Tipo de dados Propriedade
Sequências	String
Imagens	Bitmap
Ícones	Icon
Áudio	UnmanagedMemoryStream O UnmanagedMemoryStream classe deriva o Stream de classe, para que ele pode ser usado com métodos que recebem os fluxos, como o Play método.
Files	Sequência de caracteres para arquivos de texto. Bitmap para arquivos de imagem. Icon para arquivos ícone. UnmanagedMemoryStream para arquivos de som.
Outros	Determinado pela informação da coluna Type do designer.

Classes

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

Exemplo

Este exemplo define o título de um formulário para o recurso de seqüência de caracteres denominado Form1Title no arquivo de recurso do aplicativo.Para o exemplo funcione, o aplicativo deve ter uma seqüência de caracteres denominada Form1Title em seu arquivo de recurso.Para obter mais informações, consulte Como: Adicionar ou remover recursos.

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

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

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

Este exemplo define a imagem de plano de fundo de um formulário para o recurso de imagem nomeado Form1Background, que está no arquivo de recurso do aplicativo.Para esse 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

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

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

Este exemplo recupera a versão de cultura francesa de um recurso de seqüência de caracteres do aplicativo.O recurso é denominado Message.Para alterar a cultura que o My.Resources usa o objeto, o exemplo usa ChangeUICulture.

Para esse exemplo funcione, o aplicativo deve ter uma seqüência de caracteres denominada Message em seu recurso de arquivo e o aplicativo devem ter a versão de cultura francesa desse arquivo de recurso, fr-FR.Para obter mais informações, consulte Como: Adicionar ou remover recursos.Se o aplicativo não tiver a versão de cultura francesa do arquivo de recurso, o My.Resource objeto recupera 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

Tarefas

Como: Adicionar ou remover recursos

Passo a passo: Localizando Windows Forms

Conceitos

Recursos em aplicativos de Desktop

Outros recursos

Gerenciamento de recursos de aplicativo