Adicionando e Editando recursos (Visual C#)

Artigo
08/25/2010

Visual C# aplicativos geralmente incluem dados que não são o código-fonte. Esses dados são conhecidos sistema autônomo um projeto recurso e ele podem incluir dados binário, arquivos de texto, arquivos de áudio ou vídeo, tabelas de cadeias de caracteres, ícones, imagens, arquivos XML ou qualquer Outros tipo de dados que seu aplicativo requer.Projeto recurso dados são armazenados em formato XML no arquivo .resx (recursos.resx nomeado por padrão) que pode ser aberto no O gerenciador de soluções.Para obter mais informações sobre recursos de projeto, consulte Trabalhando com arquivos de recursos.

Adicionando Recursos a Projetos

Você pode adicionar recursos a um projeto clicando com o botão direito do mouse o Propriedades nó em seu projeto no O gerenciador de soluções, clicando em em abertoe, em seguida, clicando no Adicionar recurso botão a Recursos página in Designer de projeto.

Você pode adicionar recursos ao seu projeto como recursos vinculados, que são arquivos externos, ou como recursos incorporados, que são incorporados diretamente ao arquivo .resx.

Quando você adiciona um recurso vinculado, o arquivo resx. que armazena suas informações de recurso de projeto inclui apenas um caminho relativo para o arquivo de recurso no disco.Se você adicionar imagens, vídeos ou outros arquivos complexos como recursos vinculados, você pode editá-los usando um editor padrão no qual você associa a esse tipo de arquivo no Resource Designer.
Quando você adiciona um recurso incorporado, os dados são armazenados diretamente no arquivo de recurso (.resx) do projeto.Somente sequências de caracteres podem ser armazenadas como recursos incorporados.

Para obter mais informações, consulte Recursos Vinculados versus Incorporados e Recursos no Formatarar de arquivo resx.

Edição recursos

O Resource Designer permite que você adicione e modifique recursos de projeto durante o desenvolvimento ao associar um aplicativo padrão para editar cada recurso.Você acessa o recurso Designer, clique com o botão direito do mouse em Propriedades no O gerenciador de soluções, clicando em em abertoe, em seguida, clicando no Recursos guia no projeto Designer.Para obter mais informações, consulte Página de recursos, Designer de projeto.A ilustração a seguir mostra as opções de menu Resource Designer:

Para editar recursos incorporados, você deve trabalhar diretamente no arquivo .resx para manipular os caracteres individuais ou bytes.Isto é porque ele é mais conveniente para armazenar tipos de arquivos complexos como recursos vinculados durante o desenvolvimento.Você pode usar o Editor binário Para edição arquivos de recursos, incluindo o arquivo .resx, no nível binário em formato ASCII ou hexadecimal. Você pode usar o Editor de Imagemns Para edição ícones e cursores assim sistema autônomo .jpeg e arquivos GIF são armazenados sistema autônomo recursos vinculados. Você também pode escolher outros aplicativos como editores para esses tipos de arquivo.Para obter mais informações, consulte Exibindo e Editando recursos em um editor de recursos.

Compilando Recursos em Assemblies

Quando você compilação seu aplicativo, o Visual Studio chama a ferramenta resgen.exe para converter os recursos do aplicativo em uma classe interna chamada Resources. Essa classe está contida no arquivo Resources.Designer.cs que está aninhado no arquivo Resources.resx no Solution Explorer.The Resources classe encapsula todos sistema autônomo recursos do projeto em somente leitura e estático get Propriedades, sistema autônomo uma forma de fornecer recursos fortemente tipado em time de execução. Quando você constrói através do Visual C# IDE, todos os dados de recurso encapsulados, incluindo os dois recursos que foram incorporados ao arquivo .resx e os arquivos vinculados, são compilados diretamente para o aplicativo assembly (o arquivo .exe ou .dll).Em outras palavras, o Visual C# IDE sempre usa a opção /resource de compilador.Se você constrói a partir da linha de comando, você pode especificar o /linkresource opção do compilador que permitirá implantar recursos em um arquivo separado do aplicativo assembly principal. Este é um cenário avançado e só é necessário em certas situações raras.Um cenário mais comum para implantação de recursos separadamente do assembly principal do aplicativo é usar assemblies satélites conforme discutido abaixo.

Acessando Recursos em Tempo de Execução

Para acessar um recurso em tempo de execução, simplesmente referencie-o como você faria para qualquer outro membro da classe.O exemplo a seguir mostra como recuperar um recurso bitmap que você nomeou para Image01.Observe que a classe de recursos está em um namespace chamado <projectName>.Properties, portanto, você deve ou o nome totalmente qualificado para cada recurso do usuário ou então adicionar o apropriado usando o diretiva no arquivo de fonte do qual você está acessando classe Resources.

System.Drawing.Bitmap bitmap1 = myProject.Properties.Resources.Image01;

Internamente a propriedade get utiliza a ResourceManager classe para criar uma nova instância do objeto.

Para obter mais informações, consulte Recursos em aplicativos e Recurso Arquivo Generator (Resgen.exe).

Recursos em Assemblies Satélites

Se você estiver criando aplicativos que serão localizados (traduzidos) em vários idiomas, você pode armazenar cada conjunto de sequência de caracteres específicos de cada cultura como um recurso em seu próprio assembly satélite.Quando você distribuir seu aplicativo, você incluirá o aplicativo assembly principal junto com qualquer montagem satélite adequada.Você pode adicionar assemblies satélite ou modificar arquivos existentes sem recompilar o aplicativo assembly principal.Para obter mais informações, consulte Criando assemblies satélites e Localizando e usando recursos para uma cultura específica.