Walkthrough: Criando uma ação personalizada

  • Artigo

A instrução a seguir demonstra o processo de criação de uma DLL de ação personalizada para direcionar um usuário a uma página da Web no final de uma instalação. Você pode usar ações personalizadas para executar código após a conclusão da instalação.

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Para criar a ação personalizada

  1. No menu File, clique em New Project.

  2. No Novo projeto caixa de diálogo, selecione Windowse em seguida, clique em Biblioteca de classe. No nome , digite OpenWeb.

    O projeto é adicionado à Solution Explorer.

  3. No projeto menu, clique em Add Classe depois no Add New Item caixa de diálogo, selecione Classe de instalador. Aceite o nome padrão de Installer1 e clique em Add.

  4. Alterne para modo de exibição de código clicando Clique aqui para alternar para modo de exibição de código na superfície de design (ou clicando com o botão direito na superfície de design e clicando em Exibir código).

  5. No Editor de código, adicione o seguinte código (que abre um navegador da Web) para o arquivo de código de Installer1, sob o construtor.

    <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary)
    MyBase.Install(stateSaver)
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Commit(
  ByVal savedState As System.Collections.IDictionary)

    MyBase.Commit(savedState)
    System.Diagnostics.Process.Start("https://www.microsoft.com")
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary)
    MyBase.Rollback(savedState)
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary)
    MyBase.Uninstall(savedState)
End Sub

    [System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Install(IDictionary stateSaver)
{
    base.Install(stateSaver);
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Commit(IDictionary savedState)
{
    base.Commit(savedState);
    System.Diagnostics.Process.Start("https://www.microsoft.com");
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Rollback(IDictionary savedState)
{
    base.Rollback(savedState);
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Uninstall(IDictionary savedState)
{
    base.Uninstall(savedState);
}
    ObservaçãoObservação

    Se você digitar Substitui públicas e espaço, digite IntelliSense fornecerá uma lista de métodos e propriedades; Você pode selecionar Confirmar na lista e obter a declaração completa. Repita para a instalação, a reversão e métodos de desinstalação.

  6. Em Solution Explorer, arquivo de código Class1 com o botão direito e, em seguida, clique em Excluir (porque é desnecessário).

Para adicionar um projeto de implantação

  1. Sobre o arquivo , aponte para Adde, em seguida, clique em Novo projeto.

  2. No Add New Project diálogo caixa, expanda o Other Project Types nó, expanda o Setup and Deployment Projects, clique em Instalador de Visual Studioe, em seguida, clique em Setup Project. No nome , digite Instalador de ação personalizado.

    O projeto é adicionado à Solution Explorer e o File System Editor é exibido.

  3. No File System Editor, selecione A pasta de aplicativo no painel esquerdo. Sobre o ação , aponte para Adde, em seguida, clique em Saída do projeto.

  4. No Add Project Output Group caixa de diálogo, OpenWeb será exibido na projeto lista. Selecione saída principal.

    Saída primária da OpenWeb (ativo) consta o A pasta de aplicativo.

Para adicionar ação personalizada

  1. Selecione o Instalador de ação personalizado projeto em Solution Explorer. Sobre o Exibir , aponte para Editore, em seguida, clique em Custom Actions.

    O Custom Actions Editor é exibido.

  2. No Custom Actions Editor, selecione o Confirmar nó. Sobre o ação menu, clique em Add Custom Action.

  3. No Select Item in Project caixa de diálogo, clique duas vezes o A pasta de aplicativo. Selecione saída primária do OpenWeb.

    Saída primária da OpenWeb aparece sob o Confirmar nó a Custom Actions Editor.

  4. No Propriedades janela, certifique-se de que o InstallerClass for definida como True (Este é o padrão).

  5. No Custom Actions Editor, selecione o instalar nó e adicionar saída primária do OpenWeb esse nó como você fez o Confirmar nó.

  6. No Build menu, clique em Build instalador de ação personalizado.

Para instalar em seu computador de desenvolvimento

  • Selecione o Instalador de ação personalizado projeto em Solution Explorer. Sobre o projeto menu, clique em instalar.

    Isso irá executar o instalador e instalar o Instalador de ação personalizado em seu computador de desenvolvimento. No final da instalação, o Internet Explorer deve começar e deve abrir o Web site Microsoft.com.

    ObservaçãoObservação

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

Para implantar em outro computador

  1. Em Solution Explorer, o botão direito do mouse no projeto de instalação e clique em Abrir a pasta no Windows Explorer.

  2. Navegue até a saída do projeto e copiar todos os Installer.msi de ação personalizada, Setup. exe e outros arquivos e subdiretórios no diretório para outro computador.

    ObservaçãoObservação

    Para instalar em um computador que não esteja em uma rede, copie os arquivos para mídia tradicional como, por exemplo, CD-ROM.

  3. No computador de destino, clique duas vezes em Setup. exe para executar o instalador.

    No final da instalação, o Internet Explorer deve começar e deve abrir o Web site Microsoft.com.

    ObservaçãoObservação

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

    Se a .NET Framework não estiver instalado no computador de destino, essa implantação será instalado e, em seguida, esta instalação pode demorar vários minutos.

Para desinstalar o aplicativo

  1. Em O painel de controle, clique duas vezes em Adicionar ou remover programas.

  2. No Adicionar ou remover programas caixa de diálogo, selecione Instalador de ação personalizado e clique em Remover.

    Dica

    Para desinstalar o seu computador de desenvolvimento com o Instalador de ação personalizado projeto aberto e selecionado no Solution Explorer, da projeto menu, clique em desinstalar.

Consulte também

Outros recursos

Personalizar Gerenciamento de ações na implantação