Recursos vinculados e incorporados

Artigo
02/25/2013

Os projetos Visual Studio fornecem duas opções diferentes para manipular recursos; eles podem ser vinculados (o padrão) ou incorporados.Você pode ter recursos vinculados e incorporados em um único projeto.No entanto, na maioria das vezes você desejará escolher uma opção para todos os recursos em seu projeto.

Os recursos vinculados são armazenados como arquivos dentro do projeto; durante a compilação os dados dos recursos são obtidos dos arquivos e colocado no manifesto do aplicativo.O arquivo de recursos do aplicativo (.resx) armazena somente um caminho relativo ou um link para o arquivo em disco.

Com os recursos incorporados, os dado dos recursos são armazenados diretamente no arquivo .resx, em uma representação textual dos dados binários.Em ambos os casos, os dados dos recursos são compilados no arquivo executável.

Você pode alterar os recursos de vinculados para incorporados, alterando a propriedade Persistence para o arquivo de recurso.Para obter mais informações, consulte Criar recursos incorporados posteriormente neste tópico.

Observação
Os recursos string são sempre incorporados e não podem ser alterados; os recursos de arquivo são sempre vinculados e não podem ser alterados.

Escolhendo entre Recursos Incorporados e Recursos Vinculados

Em geral, você deve usar recursos vinculados, pois são mais fácil de usar.Entretanto, há casos em que os recursos incorporados podem ser uma escolha melhor.

Recursos Incorporados

Os recursos incorporados são a melhor opção se você precisa compartilhar arquivos de recurso do aplicativo (.resx) entre vários projetos.Por exemplo, se você tiver um arquivo de recurso comum que contém os logotipos de sua empresa, informação de marca, etc., usar recursos incorporados significa que você tem apenas que copiar o arquivo .resx e não os arquivos de dados de recursos associados.

Você não pode editar os recursos incorporados diretamente.Se você tentar editar um recurso incorporado, você receberá uma mensagem solicitando que você converta o item a um recurso vinculado para editá-lo.A conversão é opcional mas recomendado.Você deve exportá-los, fazer suas modificações em um programa externo, e depois importá-los de volta para seu projeto.

Criar recursos incorporados

Quando você adiciona recursos a um projeto do Visual Studio, eles são criados como recursos vinculados.Em alguns casos, convém incorporar os recursos no arquivo de recurso do aplicativo (.resx).

Os recursos podem ser alterados de vinculados a recursos incorporados na página Resources (Recursos) do Project Designer (Designer de Projeto).

Observação
Recursos que são sequências de caracteres são sempre incorporados ao arquivo .resx e não podem ser alterados para recursos vinculados; recursos que são arquivos são sempre vinculados.

Para alterar um recurso de vinculado para incorporado

Com um projeto selecionado no Solution Explorer, no menu Project, clique em Properties.
Clique na guia Resources.
Na barra de ferramentas Resource Designer, aponte para a lista suspensa de exibição de recurso, clique na seta e selecione o tipo de recurso que você deseja editar.
Selecione o recurso que você deseja alterar.
Na janela Properties, selecione a propriedade Persistence (Persistência) e altere-a para Embedded in .resx (Incorporado no .resx).

Edição de recursos incorporados

Você não pode editar recursos incorporados em um projeto do Visual Studio diretamente no IDE do Visual Studio; você deve exportá-los e editá-los em um programa externo, e em seguida importá-los de volta para o projeto.

Para exportar um recurso incorporado

Selecione um projeto no Solution Explorer e, em seguida, clique em Propriedades sobre o projeto menu.
Clique na guia Resources.A página do Resource Designer aparece com uma barra de ferramentas na parte superior.
Na primeira caixa suspensa na barra de ferramentas Resource Designer, selecione um tipo de recurso incorporado que você deseja importar, como, por exemplo, "Images", "Ícones" ou "Áudio". Todos os recursos desse tipo que existem no projeto são exibidos no Resource Designer.
Selecione o recurso que você deseja exportar, como, por exemplo, um ícone ou um arquivo de áudio.
O recurso com o botão direito e escolha Exportar para arquivo no menu de atalho.

Observação

Este comando está disponível apenas para recursos incorporados.
Na caixa de diálogo Export resource to file, procure a localidade para onde você deseja exportar o arquivo, e clique em Save.

Observação
Este comando está disponível apenas para recursos incorporados.

Para importar um recurso

Selecione um projeto no Solution Explorer e, em seguida, clique em Propriedades sobre o projeto menu.
Clique na guia Resources.A página Resource Designer aparece.
Na primeira caixa suspensa na barra de ferramentas Resource Designer, selecione um tipo de recurso incorporado que você deseja importar, como, por exemplo, "Images", "Ícones" ou "Áudio". Todos os recursos desse tipo que existem no projeto são exibidos no Resource Designer.
Selecione o recurso que você deseja importar, como, por exemplo, um ícone ou um arquivo de áudio.
O recurso com o botão direito e escolha Import From File no menu de atalho.

Observação

Este comando está disponível apenas para recursos incorporados.
Na caixa de diálogo Import file into resource, navegue até o arquivo que deseja importar, e em seguida, clique em Open

Observação
Este comando está disponível apenas para recursos incorporados.