Passo a passo: Criando DLLs satélite gerenciado
Dlls satélite são úteis para armazenar arquivos de recurso, por exemplo, ícones, bitmaps, e cadeias de caracteres de recurso, em um local centralizado para uso em suplementos e outros projetos de automação.Dlls satélite podem ser reutilizados por outros projetos ou suplementos.Além de isso, separar as cadeias de caracteres e outros recursos do 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.Em o entanto, as entradas de Registro agora são substituídas por entradas no arquivo de registro de .addin.Quando você requer um recurso em seu projeto, você carrega o suplemento e Visual Studio consulta para a DLL satélite.Portanto, você não tem que irá embutir um caminho de recurso.Além de isso, em vez de usar o método de #id para especificar uma identificação de recurso, você usanome do recurso @ ( nome do recurso onde é o nome do recurso, por exemplo, @Icon1 ou @String1 @), o símbolo informa Visual Studio para procurar no DLL satélite para o recurso.
Crie DLL satélite gerenciados
As etapas a seguir mostram como criar uma DLL satélite que contém recursos do ícone e da cadeia de caracteres, e alterar um suplemento para acessar os recursos.Usa um suplemento que tem uma caixa de diálogo de Sobre , que requer recursos do ícone e da cadeia de caracteres.Normalmente, se você criar um suplemento que tem uma caixa de diálogo de Sobre , um ícone padrão e o texto é fornecido.As seguintes etapas também mostram como substituir o ícone e o texto padrão usando seu próprio.
Para criar uma DLL satélite gerenciado
No menu File, clique em New, e em seguida, clique em Project
Em a caixa de diálogo de Novo ProjetoOutros tipos de projetos , expanda e selecione Projetos de extensibilidade.
Em o painel de Modelos , Suplemento do Visual Studioselecione.
Siga as instruções no assistente de suplementos do Visual Studio.Em a página de Escolhendo a “ajuda” informações sobre , Sim, eu gostaria de my suplemento oferecem a “em” informações da caixaselecione.Aceitar as seleções padrão restantes.
No menu Project, escolha Add Reference.
Em a guia de .NET , clique em System.Drawing, e clique em OK.
Clique com o botão direito do mouse no projeto do suplemento em Gerenciador de Soluções, clique Adicionar, clique em Novo Item.
Selecione Arquivo de Recursos na lista de modelos e clique Adicionar.Aceite o nome padrão (Resources1.resx).
Por padrão, isso cria um arquivo de recurso chamado Resource1.resx e começa Visual StudioEditor de Recurso.
Em Ícones Resource1.resx, selecione na lista de cadeias de caracteres (o botão mais à esquerda na parte superior).
Em a lista de Adicionar Recurso , clique adicionar o novo ícone.Por enquanto, deixe o nome padrão (Icon1.bmp) e clique Adicionar.
Como alternativa, você pode selecionar uma imagem de bitmap existente para o ícone, desde que é 16 x 16 pixels e qualquer um da cor 16 ou cor verdadeira.
Depois que o ícone abre em Editor de Ícone, use as ferramentas para modificá-lo.Quando você terminar, feche Editor de Ícone e salvar suas alterações.
Selecione Adicionar nova cadeia de caracteres na lista de Adicionar Recurso .
Clique na primeira caixa na coluna de Nome .
Isso cria um recurso de cadeia de caracteres padrão String1 chamado.
Tipo Uma linha na caixa de Valor .
Este é o valor para o recurso da primeira cadeia de caracteres.
Crie dois mais recursos de cadeia de caracteres, e nomeie-os “para alinhar dois” e “alinhe três”.
Editor de Recurso Fechar e salvar as alterações.
Em Gerenciador de Soluções, clique com o botão direito do mouse Resource1.resx e clique em Propriedades.
Em a janela de Propriedades , altere Ação de Compilação de Recurso Incorporado a Nenhum.
Isso impede que o recurso seja compilado no assembly do suplemento.
Crie o projeto.
Crie o DLL de recursos de satélite.Isso é feito em um processo de duas etapas usando ResGen e AL (vinculador assembly) para compilar no DLL satélite.
Clique Iniciar, Todos os Programas, Microsoft Visual Studio 2010, O Visual Studio, 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 de Visual Studio .
Em o 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 especificado .resx em um arquivo .resources.Para mais informações, consulte Resgen. exe (gerador do arquivo de recurso).
Em o 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 do suplemento.Por exemplo, se seu projeto de suplemento é chamado MyAddin, então a opção de /out: é /out:MyAddin.resources.dll.O nome de /out: deve corresponder ao nome do projeto; caso contrário, o DLL de recursos não será localizado.
Vinculador assembly (AL.exe) converte o arquivo .resources especificado 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 mais informações, consulte AL.exe (do Assembly Linker).
Em o Arquivo Explorer, vá para o diretório de DLL do suplemento e crie uma pasta chamada \. \). USADO para E. (EUA. inglês, porque você digitou en-us. U. como o valor de cultura em AL.exe).
Copie o arquivo de Nome do suplemento.resources.dll para o novo \. \). FOR pasta.
Em o Arquivo Explorer, vá para o diretório \ \ suplementos, normalmente.\ Documents and settings \nome de usuário\ my documents \ Visual Studio 2010 \ \ suplementos.
Modifique o arquivo de definição do suplemento ao Visual Studio seguinte maneira:
Clique com o botão direito do mouse no arquivo de definição do suplemento para o suplemento, clique Abrir com, clique em Preenchimento de nota.
Substitua as seguintes marcas:
<FriendlyName>@String1</FriendlyName> <Description>@String2</Description> <AboutBoxDetails>@String3</AboutBoxDetails> <AboutIconData>@Icon1</AboutIconData>A entrada de Friendlyname renomeia o suplemento a Line1, que é o que você digitou para String1 no arquivo Resource1.resx.A descrição na caixa de diálogo de Sobre agora contém “Line2”, e a entrada de AboutIconData corresponde ao ícone que você criou para a caixa de diálogo de Sobre .
Inserir .resources antes de extensão do nome do assembly.
Crie o projeto e selecione o suplemento em Gerenciador de Suplementos.
Em o menu de Ajuda , clique em Em o Microsoft Visual Studio e em Line1 selecione (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 de satélite