Demonstra Passo a passo: Usando uma ação personalizada para exibir uma mensagem na instalação

A seguinte explicação passo a passo demonstra como usar uma ação personalizada para tirar a entrada do usuário e passá-lo para uma caixa de mensagem que aparece durante a instalação.Esta é uma demonstração simples de ações personalizadas, que são úteis para muitas outras tarefas.Por exemplo, uma ação personalizada pode ser sistema autônomo o usuário inserir o local do arquivo Setup.exe e usá-lo para inicialização o aplicativo após instalá-lo.

Esta explicação passo a passo demonstra passando dados para uma propriedade dinâmica usando uma ação personalizada e como usar uma classe de instalador e o CustomActionDatapropriedade .

Observação:
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, clicar Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Observação:
As instruções a seguir demonstram a criação de um projeto de implantação usando um projeto Visual Basic; os princípios Geral se aplicam a todos os projetos de linguagem do Visual Studio que oferecem suporte à implantação de aplicativos do Windows.

Para criar uma ação personalizada

1. No menu File, aponte para New, e em seguida, clique em Project.

2. No Novo projeto caixa de diálogo , selecionar Visual Basic in the Tipos de projeto painel e, em seguida, escolher biblioteca de classes in the Modelos painel.No Nome box, type PassData.

   O projeto é adicionado ao O gerenciador de soluções.

Para criar uma classe de instalador

1. No menu Project clique em Add Class.

   No Adicionar novo item caixa de diálogo, choose Classe de instalador.Aceite o nome padrão.

2. Quando a classe de instalador aparece na área de design, clicar com o botão direito do mouse na área de design e clique em Exibir código para exibir o Sumário do arquivo no editor de código.

3. Adicione o seguinte procedimento para substituir o Instalar procedimento da classe base:

   Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary)
       MyBase.Install(stateSaver)
       Dim myInput As String = Me.Context.Parameters.Item("Message")
       If myInput Is Nothing Then
           myInput = "There was no message specified"
       End If
       MsgBox(myInput)
   End Sub
   

   Observação:
   Se você digitar Substituições públicase, em seguida, tipo de espaço, IntelliSense fornecerá uma lista de métodos e propriedades; você pode selecionar Instalar na lista e obter a declaração completa.

4. In O gerenciador de soluções, clicar com o botão direito do mouse em Class1.vb e selecionar Excluir (porque é desnecessário).

Para criar um projeto de implantação

1. No menu File, aponte para Add, e clique New Project.

2. No Adicionar novo projeto caixa de diálogo, no Tipo de projeto painel, expandir o Outros tipos de projeto nó e selecionar Instalação e implantação, em seguida, escolher Projeto de instalação in the Modelos pane.No Nome caixa, digite PassData Installer.

3. No Propriedades janela, selecionar o ProductName propriedade e tipo PassData.

   Além disso, selecionar o Fabricante propriedade e tipo de minha empresa.

4. No Editor de arquivo do sistema, selecionar o Pasta de aplicativo nó.Sobre o Ação , aponte para Adicionar, em seguida, clicar Saída do projeto.

5. No Adicionar Project Output agrupar caixa de diálogo, selecionar saída principal para o PassDataprojeto .

   Primary output fromPassData (Active) appears in the File System Editor.

Para adicionar uma ação personalizada

1. selecionar o PassData Installer projeto em O gerenciador de soluções.Sobre o Modo de exibição , aponte para Editore, em seguida, clicar Ações personalizadas.

2. No Editor de ações personalizadas, selecionar o (nível superior) Instalar nó.Sobre o Ação menu, clicar Adicionar ação personalizada.

3. No selecionar o item in projeto diálogo caixa, clicar duas vezes o Pasta de aplicativo.

   selecionar Saída primária do PassData (ativo).Isso adicionará PassData ação personalizada para o nó de instalar.

4. No Propriedades janela, selecionar o CustomActionData propriedade e tipo de / Mensagem = "[mensagem]".

   Certifique-se de que o InstallerClass propriedade estiver definida como True (Este é o padrão).

Para personalizar a instalação da interface do usuário

1. selecionar o projeto de instalação em O gerenciador de soluções.Sobre o Modo de exibição , aponte para Editore, em seguida, clicar Interface do usuário.

2. No Editor de interface do usuário, selecionar o Iniciar nó Instalar.Sobre o Ação menu, clicar Caixa de diálogo Adicionar.

3. No Caixa de diálogo Adicionar diálogo, selecionar o Caixas de texto (A) da caixa de diálogo.

4. Sobre o Ação menu, clicar Mover para cima.Repetir até que o Caixas de texto (A) caixa de diálogo está acima de Pasta de instalação nó.

5. No Propriedades janela, selecionar o BannerText propriedade e digite:

   Qual é a mensagem?

6. selecionar o Exigidas propriedade e digite:

   Digite sua mensagem aqui.

7. selecionar o Edit1Label propriedade e digite:

   Mensagem:

8. selecionar o Edit1Property propriedade e digite:

   MENSAGEM

9. selecionar o Edit2Visible, Edit3Visible, and Edit4Visible propriedades e defina-os para False.

10. Sobre o Compilação menu, clicar Compilação passar dados Installer.

Para instalar o seu computador de desenvolvimento

• selecionar o PassData Installer projeto em O gerenciador de soluções.Sobre o Projeto menu, clicar Instalar.

  Isso será executado o instalador em seu computador de desenvolvimento.No Qual é sua mensagem? instalação caixa de diálogo tipo Olá mundo!.

  Observação:
  Você deve ter as permissões de instalar no computador para executar o instalador.

Para implantar em outro computador

1. In Windows Explorer, navegar para o diretório de projeto e localize o instalador integrado.O caminho padrão será \Documents and Settings\ yourloginname\Meus Documentos\Visual studio 2005\Projects\Nome da pasta de solução\Meus Installer\ notepadconfiguração de projeto \Meus Installer.msi o bloco de notas.O padrão de configuração de projeto é um dos Depurar or Versão.

2. Copie PassData Installer.msi, Setup.exe, todos os outros arquivos e subdiretórios no diretório para outro computador.

   Observação:
   Para instalar em um computador que não esteja em uma rede, copie sistema autônomo arquivos em mídia tradicional, sistema autônomo CD-ROM.

   No computador de destino, clicar duas vezes em Setup.exe para executar o instalador.No Qual é sua mensagem? instalação caixa de diálogo tipo Olá mundo!.

   Observação:
   Você deve ter as permissões de instalar no computador para executar o instalador.

Para testar a instalação

• Execute o aplicativo e verifique se a caixa de texto contém o texto 'Hello World!', que você inseriu durante a instalação.

Para desinstalar o aplicativo

1. No Windows Painel de controle, clicar duas vezes em Adicionar ou remover programas.

2. No Adicionar ou remover programas caixa de diálogo de de seleçãoPassData Installer e clicar Remover, em seguida, clicar OK para fechar a caixa de diálogo.

   Dica:
   Desinstalar de seu computador de desenvolvimento, nas Projeto menu, clicar Desinstalar o.

Consulte também

Referência

Propriedade CustomActionData

Outros recursos

Gerenciamento de ações personalizadas no implantação

Usando componentes de instalação