Demonstra Passo a passo: Criar DLLs satélite gerenciado
DLLs satélite são úteis para armazenar arquivos de recurso, sistema autônomo ícones, bitmaps e seqüências de recursos em um local centralizado para uso em suplementos e outros projetos de automação.DLLs satélite podem ser reutilizadas por outros projetos ou add-ins.Além disso, separar as seqüências e outros recursos de seu suplemento torna mais fácil fazer alterações centralizadas ou localizar os recursos em diferentes idiomas.
O Visual Studio .NET 2002 e Visual Studio .NET 2003 usado entradas do registro para SatelliteDllPath e SatelliteDllName.No entanto, em Visual Studio 2005, as entradas do inscrição são substituídas por entradas no arquivo de inscrição .Addin. Quando você precisar de um recurso em seu projeto, você carregar o suplemento e Visual Studio ele consulta o satélite DLL, assim como outros componentes gerenciado. Conseqüentemente, não é necessário codificação dura um caminho de recurso.Além disso, em vez de usar o método #id para especificar uma identificação de recurso, você usar @ < nome do recurso > (onde "<nome do recurso > é o nome do recurso, sistema autônomo @ Icon1 ou @ seqüência1), O símbolo @ indicaVisual Studio Se ele deve procurar o DLL satélite do recurso.
Criar DLLs satélite gerenciado
O procedimento a seguir demonstra como criar um ícone de recipiente de DLL satélite e recursos de seqüência de caracteres e como alterar um suplemento para acessar esses recursos.Ele usa um suplemento que possui um Sobre a caixa, que requer recursos de ícone e a seqüência de caracteres.Normalmente, se você criar um suplemento com um Sobre a caixa, um ícone padrão e texto são fornecidos.O procedimento a seguir mostra como substituir que com um ícone e texto de sua escolha.
Para criar uma DLL satélite gerenciado
No menu File, aponte para New e clique Project.
A Caixa de diálogo New Project é aberta.
expandir Outros tipos de projeto e, em seguida, selecionar Projetos de extensibilidade.
No Modelos seleção do painel de O Visual Studio suplemento.
Siga as instruções do Visual Studio suplemento assistente.Sobre o Escolha 'Ajuda sobre' Information de página, verifique o Sim, eu gostaria que o suplemento ofereça 'informações da caixa sobre' a caixa de seleção.Aceite as opções padrão restantes.
In O gerenciador de soluções, selecionar o projeto suplemento e, no Projeto menu, clicar Mostrar todos os arquivos.
No menu Project, escolha Add Reference.
Sobre o NET guia, clicar sistema.desenho e, em seguida, clicar OK.
clicar com o botão direito do mouse o projeto em suplementoO gerenciador de soluções.
Aponte para Adicionar e clicar Novo item.
selecionar Arquivo de recursos nos modelos de lista e clicar no Adicionar botão.Deixe seu nome padrão (Resources1.resx).
This starts the Visual Studio Resource Editor.
Por padrão, isso cria um arquivo de recurso chamado Resource1.resx.
No Resource1.resx, selecionar Ícones from the Seqüências de caracteres suspenso na parte superior (o botão mais à esquerda na parte superior).
No Adicionar recurso área suspensa, clicar Adicionar novo ícone.Por enquanto, deixe seu nome padrão (Icon1.bmp) e clicar Adicionar.
sistema autônomo alternativa, você pode selecionar uma imagem de bitmap existente para o ícone, desde que ele seja 16 x 16 pixels e 16 color ou True Color.Ícones personalizados para suplementos devem ser 16 x 16 pixels e 16 cores ou True Color.
Depois que o ícone é aberta no Editor de ícone, use as ferramentas para alterá-lo.Ao terminar, fechar o Editor de ícone e salvar suas alterações.
selecionar Adicionar nova string from the Adicionar recurso suspenso.
clicar na primeira caixa no Nome coluna.
Isso cria um novo recurso de seqüência de caracteres padrão chamado seqüência1.
Tipo de Linha um in the Valor box.
Esse é o valor para o primeiro recurso em seqüência.
Crie dois mais recursos de seqüência de caracteres, nomeação-los "Linha dois" e "linha três".
fechar o recurso Editor e salvar as alterações.
In O gerenciador de soluções, clicar com o botão direito do mouse Resource1.resx e selecionar Propriedades.
No Propriedades janela, alterar de compilação Ação from Recursos incorporados to Nenhum.
Isso impede que o recurso sendo compilado no assembly suplemento.
Crie o projeto.
Criar o satélite DLL de recurso.Isso é concluído em um processo de duas etapas usando ResGen e, em seguida, AL (do Assembly vinculador) para criar o DLL satélite.
clicar no Windows Iniciar botão, ponto de Todos os programas, point to Microsoft Visual Studio 2005, point to O Visual Studio Toolse clicar Microsoft Visual Studio 2005 Command aviso.
Isso define certas variáveis de ambiente para que você pode referenciar mais com com facilidade Visual Studio ferramentas.
No aviso de comando, vá para a pasta que contém o arquivo .resx e digite Resgen Resource1.resx.
ResGen é um utilitário que compila o arquivo .resx especificado em um arquivo .Recursos.Para obter mais informações, consulte Recurso Arquivo Generator (Resgen.exe).
Novamente, no aviso de comando, digite o seguinte: Al.exe /embed:Resource1.resources /culture:en-US /out:<Add-In Name>.resources.dll.
Substitua < Nome do Suplemento > com o nome do seu suplemento.Por exemplo, se seu projeto suplemento for MyAddin nomeado e, em seguida, o /out: comutador seria /out:MyAddin.Recursos.dll./Out: nome deve corresponder ao nome do seu projeto ou que o recurso que dll não será encontrado.
Al.exe (do Assembly vinculador) converte o arquivo .Recursos especificado em uma DLL que você pode referenciar no seu suplemento.(Você pode alterar comutador /cultura para um linguagem diferente do inglês.) Para obter mais informações, consulte Vinculador do conjunto (AL.exe) .
Usando Windows Explorer, vá para diretório de DLLs do suplemento e criar uma pasta chamada en-US (para inglês-EUA, sistema autônomo você digitou en-US sistema autônomo o valor de cultura no AL).
Copie o arquivo de.Recursos.dll < Nome do Suplemento > para a nova pasta en-US.
Usando o Windows Explorer, navegue até o diretório de suplementos.Geralmente <unidade>: \Documents and Settings\ <nome de usuário > \Meus Documentos\Visual studio 2005\Addins.
Modifique o arquivo de definição de suplemento Visual Studio, fazendo o seguinte:
clicar com o botão direito do mouse no arquivo de definição do suplemento para seu suplemento e selecionar em em aberto com no menu de atalho.selecionar Área de nota na lista de programas.
Dentro do <addin></addin> Rótulos, fazer as seguintes modificações:
<Addin> <FriendlyName>@String1</FriendlyName> <Description>@String2</Description> <AboutBoxDetails>@String3</AboutBoxDetails> <AboutIconData>@Icon1</AboutIconData> <Assembly><installation root>\my documents\visual studio 2005\Projects\MyAddin1\MyAddin1\bin\MyAddin1.dll</Assembly> <FullClassName>MyAddin1.Connect</FullClassName> <LoadBehavior>0</LoadBehavior> <CommandPreload>0</CommandPreload> <CommandLineSafe>0</CommandLineSafe> </Addin>Substitua o <raiz de instalação > dentro do <assembly></assembly> Rótulos com o caminho do arquivo no seu computador.
A entrada FriendlyName renomeia o suplemento para linha1, que é o que você inseriu para seqüência1 no arquivo Resource1.resx.A descrição na caixa de ajuda sobre contém "Linha2" e a entrada AboutIconData coincide com o ícone na caixa de ajuda sobre para o ícone que você criou na etapa sete (7).
recompilar o projeto e selecionar o suplemento no Gerenciador de suplemento.
Sobre o Ajuda menu, clicar no Sobre o Microsoft Visual Studio comando e selecionar Linha1 (o nome do seu suplemento) na lista.
Você verá o novo ícone personalizado e três cadeias de caracteres criada no Sobre a caixa.
Consulte também
Tarefas
Como: Recursos do acesso em DLLs satélite