Walkthrough: Criar DLLs satélite gerenciado
DLLs satélite são úteis para armazenar arquivos de recurso, por exemplo, ícones, bitmaps e seqüências de recursos, em um local centralizado para usam no add-ins e outros projetos de automação. DLLs satélite podem ser reutilizadas por outros projetos ou suplementos. Além disso, separar as seqüências e outros recursos de seu suplemento torna mais fácil fazer alterações de centralizado ou localizar os recursos em diferentes idiomas.
Versões anteriores do Visual Studio usado entradas do registro para SatelliteDllPath e SatelliteDllName. No entanto, as entradas do registro agora são substituídas por entradas no arquivo de registro. addin. Quando você precisar de um recurso em seu projeto, você pode carregar o suplemento e Visual Studio o consultará para satélite DLL. Conseqüentemente, você não precisará codificar um caminho de recurso. Além disso, em vez de usar o método #id para especificar uma identificação de recurso, use @nome do recurso (onde nome do recurso é o nome do recurso, por exemplo, @ Icon1 ou @ seqüência1), O símbolo @ informa Visual Studio para examinar o satélite DLL para o recurso.
Criar DLLs satélite gerenciado
As etapas a seguir mostram como criar uma DLL que contém recursos de ícone e a seqüência de caracteres de satélite e como modificar um add-in para acessar esses recursos. Ele usa um suplemento que tem um sobre caixa de diálogo que requer recursos de ícone e a seqüência de caracteres. Normalmente, se você criar um suplemento que tem um sobre caixa de diálogo, um ícone padrão e texto são fornecidos. Também, as etapas a seguir mostram como substituir o ícone padrão e o texto usando seu próprio.
Para criar um DLL gerenciado do satélite
No menu File, clique em New, e em seguida, clique em Project
No Novo projeto caixa de diálogo caixa, expanda Other Project Types e selecione Os projetos de extensibilidade.
No modelos de painel, selecione - in Visual Studio.
Siga as instruções no Assistente de suplemento de Visual Studio. Sobre o escolhendo 'Ajuda sobre' Informações página, selecione Sim, eu gostaria que meu suplemento oferecem 'Sobre' caixa de informações. Aceite as seleções restantes do padrão.
No menu Project, escolha Add Reference.
Sobre o .NET guia, clique em System. Drawing e então clique em OK.
Clique com o botão direito no projeto do suplemento na Solution Explorer, clique em Adde em seguida, clique em Novo Item.
Selecione O arquivo de recursos nos modelos de lista e clique em Add. Aceite o nome padrão (Resources1.resx).
Por padrão, isso cria um arquivo de recurso, chamado Resource1.resx e inicia a Visual Studio Editor de recursos.
Na Resource1.resx, selecione ícones sobre o seqüências lista (o botão mais à esquerda na parte superior).
No Add Resource , clique em Adicionar um novo ícone. Por enquanto, deixe o nome padrão (Icon1.bmp) e clique em Add.
Como alternativa, você pode selecionar uma imagem de bitmap existente para o ícone, como é 16 x 16 pixels e 16 cores ou True Color.
Depois que o ícone abre no O Editor de ícone, use as ferramentas para modificá-lo. Quando terminar, feche o O Editor de ícone e salvar suas alterações.
Selecione Adicionar nova cadeia de caracteres sobre o Add Resource lista.
Clique na primeira caixa de nome coluna.
Isso cria um recurso de seqüência de caracteres padrão chamado String1.
Tipo de linha de na valor caixa.
Esse é o valor para o primeiro recurso de string.
Criar mais de dois recursos de seqüência de caracteres e nomeá-los a "Linha dois" e "Linha três".
Fechar o Editor de recursos e salvar as alterações.
Em Solution Explorer, Resource1.resx com o botão direito e, em seguida, clique em Propriedades.
No Propriedades janela, alterar Build Action de Embedded Resource para Nenhum.
Isso impede que o recurso sendo compilado no assembly add-in.
Crie o projeto.
Crie a DLL de recurso de satélite. Isso é feito em um processo de duas etapas, usando ResGen e, em seguida, AL (do Assembly Linker) para criar a DLL satélite.
Clique em Iniciar, Todos os programas, Microsoft 2010 de Visual Studio, Visual Studio Toolse em seguida, clique em Prompt de comando de Visual Studio do Microsoft (2010).
Isso define algumas variáveis de ambiente para que você pode referenciar mais facilmente Visual Studio Ferramentas.
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 de especificado em um arquivo. Resources. Para obter mais informações, consulte Resgen. exe (gerador do arquivo de recurso).
No prompt de comando, digite AL.exe /embed:Resource1.resources /culture:en-US /out:Nome do suplemento.resources.dll.
Substitua Nome do suplemento usando o nome de seu suplemento. Por exemplo, se o seu projeto de suplemento chamado MyAddin, em seguida, a /out: opção seria /out:MyAddin.resources.dll. O /out: nome deve coincidir com o nome do projeto. Caso contrário, o recurso DLL será não encontrado.
AL.exe (do Assembly Linker) converte o arquivo. Resources de especificado uma DLL que você pode referenciar no seu suplemento. (Você pode alterar o /culture Alternar para um idioma diferente do inglês.) Para obter mais informações, consulte AL.exe (do Assembly Linker).
No Windows Explorer, navegue até o diretório DLL do suplemento e crie uma pasta chamada \en-US\ (para inglês-EUA, como você digitou en-US como o valor da cultura AL.exe).
Cópia de Nome do suplemento. arquivo de Resources.dll para a nova pasta de \en-US\.
No Windows Explorer, navegue até o diretório \Addins\, geralmente.. \Documents and Settings \nome de usuárioDocumentos\Visual Studio 2010\Addins\.
Modifique o arquivo de definição de suplemento de Visual Studio como segue:
O arquivo de definição de add-in para seu suplemento com o botão direito, clique em Abrir come em seguida, clique em Bloco de notas.
Substitua as seguintes marcas:
<FriendlyName>@String1</FriendlyName> <Description>@String2</Description> <AboutBoxDetails>@String3</AboutBoxDetails> <AboutIconData>@Icon1</AboutIconData>A entrada Friendlyname renomeia o add-in para linha1, que é inserida para seqüência1 no arquivo Resource1.resx. A descrição no sobre caixa de diálogo agora contém "Linha2" e a entrada de AboutIconData coincide com o ícone que você criou para o sobre caixa de diálogo.
Insira o. Resources antes da extensão do nome do assembly.
Reconstruir o projeto e selecione add-in em Gerenciador de suplementos.
Sobre o Ajuda menu, clique em Sobre Microsoft Visual Studio e selecione linha1 (o nome de seu suplemento) na lista.
O ícone personalizado e três seqüências de caracteres que você criou são exibidas.
Consulte também
Tarefas
How to: Acessar Recursos em DLLs de satélite