Instruções passo a passo: criando DLLs satélite gerenciadas
No vs_dev12, os suplementos foram preteridos. Recomendamos que você atualize seus suplementos para as extensões VSPackage. Para obter mais informações sobre como atualizar, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.
As DLLs satélite são úteis para armazenar arquivos de recursos, por exemplo, ícones, bitmaps e cadeias de caracteres de recurso, em um local centralizado para uso nos suplementos e outros projetos de automação. As DLLs satélite podem ser reutilizadas por outros projetos ou suplementos. Além disso, separar as cadeias de caracteres e outros recursos do seu suplemento facilita fazer alterações centralizadas ou localizar os recursos em diferentes idiomas.
As versões anteriores do Visual Studio usaram entradas do Registro para SatelliteDllPath e SatelliteDllName. No entanto, as entradas do Registro agora são substituídas por entradas do arquivo de registro .addin. Quando você requer um recurso em seu projeto, você carrega o suplemento e consultas Visual Studio para o DLL satélite. Consequentemente, não é preciso codificar um caminho de recurso. Além disso, em vez de usar o método de #id para especificar uma identificação de recurso, use @resource name (onde resource name é o nome do recurso, por exemplo, @Icon1 ou @String1). O símbolo @ informa ao Visual Studio para procurar pelo recurso na DLL satélite.
Criar DLLs de satélite gerenciadas
As etapas a seguir mostram como criar uma DLL satélite que contém recursos do ícone e da cadeia de caracteres, bem como modificar um suplemento para acessar esses recursos. Usa um suplemento com uma caixa de diálogo Sobre, que requer recursos de ícone e de cadeia de caracteres. Normalmente, se você criar um suplemento que tem uma caixa de diálogo Sobre, um ícone padrão e um texto são fornecidos. As etapas a seguir também mostram como substituir o ícone e o texto padrão usando seus próprios.
Para criar uma DLL satélite gerenciada
No menu Arquivo, clique em Novo e em Projeto.
Na caixa de diálogo Novo Projeto, expanda Outros Tipos de Projeto e então selecione Projetos de Extensibilidade.
Na lista Modelos, selecione Suplemento do Visual Studio.
Siga as instruções do Assistente de Suplementos do Visual Studio. Na página Escolhendo as informações de "Ajuda Sobre", selecione a opção de Sim, eu gostaria que meu suplemento oferecesse informações na caixa "Sobre". Aceite as seleções padrão restantes.
No menu Projeto, clique em Adicionar Referência.
Na guia .NET, clique em System.Drawing e, em seguida, clique em OK.
Clique com o botão direito no projeto de suplemento no Gerenciador de Soluções, clique em Adicionar e em Novo Item.
Selecione Arquivo de Recursos na lista Modelos e clique em Adicionar. Aceite o nome padrão (Resources1.resx).
Por padrão, isso cria um arquivo de recurso chamado Resource1.resx e inicia o Visual Studio Editor de Recurso.
Em Resource1.resx, selecione Ícones na lista Cadeias de Caracteres (o botão mais à esquerda na parte superior).
Na lista Adicionar Recurso, clique em Adicionar Novo Ícone. Por enquanto, deixe o nome padrão (Icon1.bmp) e clique em Adicionar.
Como alternativa, você pode selecionar uma imagem de bitmap existente para o ícone, desde que seja de 16 x 16 pixels e 16 cores ou True Color.
Após o ícone abrir no Editor de Ícone, use as ferramentas para modificá-lo. Quando você terminar, feche Editor de Ícone e salve suas alterações.
Selecione Adicionar Nova Cadeia de Caracteres na lista Adicionar Recurso.
Clique na primeira caixa na coluna Nome.
Isso cria um recurso padrão de cadeia de caracteres denominado String1.
Digite Linha um na caixa Valor.
Este é o valor para o primeiro recurso da cadeia de caracteres.
Crie outros dois recursos de cadeia de caracteres e chame-os de "Linha dois" e "Linha três".
Feche o Editor de recursos e salve as alterações.
No Gerenciador de Soluções, clique com o botão direito em Resource1.resx e clique em Propriedades.
Na janela Propriedades, altere Ação de Compilação de Recurso Incorporado para Nenhum.
Isso impede o recurso de ser integrado ao assembly do suplemento.
Crie o projeto.
Crie a DLL de recurso de satélite. Isso é feito em um processo de duas etapas usando ResGen e AL (Assembly Linker) para compilar a DLL satélite.
Clique em Iniciar, Todos os programas, Microsoft Visual Studio 2010, Ferramentas do Visual Studio e, em seguida, clique em Prompt de comando do Microsoft Visual Studio (2010).
Isso define certas variáveis de ambiente para que você possa mais facilmente referenciar ferramentas do Visual Studio.
No prompt de comando, vá para a pasta que contém o arquivo .resx e o tipo Resgen Resource1.resx.
Resgen é um utilitário que compila o arquivo .resx especificado em um arquivo de recurso. Para obter mais informações, consulte Resgen.exe (Gerador de Arquivo de Recurso).
No prompt de comando, digite AL.exe /embed:Resource1.resources /culture:en-US /out:Add-In Name.resources.dll.
Substitua Add-In Name usando o nome do suplemento. Por exemplo, se seu projeto de suplemento se chamar MyAddin, então a opção /out: será /out:MyAddin.resources.dll. O nome de /out: deve corresponder ao nome do projeto. Caso contrário, a DLL de recurso não será localizada.
O AL.exe (vinculador assembly) converte o arquivo especificado .resources em uma DLL que você pode referenciar no suplemento. (Você pode alterar a opção de /culture para um idioma diferente do inglês.) Para obter mais informações, consulte Al.exe (Assembly Linker).
No Explorador de Arquivos, navegue até o diretório DLL do suplemento e crie uma pasta chamada \en-US\ (para Inglês (EUA), porque você digitou en-US como o valor de cultura em AL.exe).
Copie o arquivo Add-In Name.resources.dll file para a nova pasta \en-US\.
No Explorador de Arquivos, navegue até o diretório \Addins\ directory, geralmente ..\Documents and Settings\user name\Meus Documentos\Visual Studio 2010\Addins\.
Modifique o arquivo de definição do suplemento do Visual Studio como a seguir:
Clique com o botão direito do mouse no arquivo de definição do seu suplemento, clique em Abrir com e em Bloco de Notas.
Substitua as seguintes marcações:
<FriendlyName>@String1</FriendlyName> <Description>@String2</Description> <AboutBoxDetails>@String3</AboutBoxDetails> <AboutIconData>@Icon1</AboutIconData>A entrada Friendlyname renomeia seu suplemento para Line1, que é o que você digitou para String1 no arquivo Resource1.resx. A descrição na caixa de diálogo Sobre agora contém “Line2”, e a entrada AboutIconData corresponde ao ícone que você criou para a caixa de diálogo Sobre.
Insira .resources antes de extensão do nome do assembly.
Recrie o projeto e selecione o suplemento Gerenciador de Suplementos.
No menu de Ajuda, clique em Sobre o Microsoft Visual Studio e selecione Line1 (o nome do suplemento) na lista.
O ícone personalizado e as três cadeias de caracteres que você criou são exibidos.
Consulte também
Tarefas
Como acessar recursos em DLLs satélite