Walkthrough: Usando uma ação personalizada para exibir uma mensagem na instalação

  • Artigo

A instrução a seguir 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 simple de ações personalizadas, que são úteis para muitas outras tarefas. Por exemplo, uma ação personalizada poderia levar à medida que o usuário inserir o local do arquivo Setup. exe e usá-lo para iniciar o aplicativo depois de 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 CustomActionData propriedade.

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 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, selecione Visual Basic na Tipos de projeto painel e escolha Class Library na modelos painel. No nome , digite PassData.

    O projeto é adicionado à Solution Explorer.

Para criar uma classe de instalador

  1. No menu Project clique em Add Class.

    No Add New Item caixa de diálogo caixa, escolha A classe de instalador. Aceite o nome padrão.

  2. Quando a classe de instalador aparece na superfície de design, o botão direito do mouse na superfície de design e clique em Exibir código para exibir o conteúdo do arquivo no editor de código.

  3. Adicione o seguinte procedimento para substituir o instalar, Confirmar, reversão, e desinstalar os procedimentos 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

Public Overrides Sub Commit(ByVal savedState As System.Collections.IDictionary)
    MyBase.Commit(savedState)
End Sub

Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary)
    MyBase.Rollback(savedState)
End Sub

Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary)
    MyBase.Uninstall(savedState)
End Sub

    public override void Install(System.Collections.IDictionary stateSaver)
{
    base.Install(stateSaver);
    string myInput = Context.Parameters["message"];
    if (myInput == null)
    {
        myInput = "There was no message specified";
    }
    MessageBox.Show(myInput);
}

public override void Commit(IDictionary savedState)
{
    base.Commit(savedState);
}

public override void Rollback(IDictionary savedState)
{
    base.Rollback(savedState);
}

public override void Uninstall(IDictionary savedState)
{
    base.Uninstall(savedState);
}
    ObservaçãoObservação

    Se você digitar Substitui públicas, em seguida, digite o espaço, Intellisense fornecerá uma lista de métodos e propriedades; Você pode selecionar instalar na lista e obter a declaração completa.

  4. Em Solution Explorer, com o botão direito do Class1 o arquivo de código e selecione Excluir (porque é desnecessário).

Para criar um projeto de implantação

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

  2. No Add New Project na caixa a Tipo de projeto painel, expandir o Other Project Types nó e selecione Setup and Deployment, em seguida, escolha Setup Project no modelos painel. No nome , digite PassData Installer.

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

    Além disso, selecione o fabricante propriedade e o tipo de minha empresa.

  4. No File System Editor, selecione o A pasta de aplicativo nó. Sobre o ação , aponte para Adicionar, em seguida, clique em Saída do projeto.

  5. No Add Project Output Group caixa de diálogo, selecione a saída primária para a PassData project.

    Saída primária do PassData (ativo) consta o File System Editor.

Para adicionar uma ação personalizada

  1. Selecione o passdata Installer projeto em Solution Explorer. Sobre o Exibir , aponte para Editore, em seguida, clique em Custom Actions.

  2. No Custom Actions Editor, selecione o nível (superior) instalar nó. Sobre o ação menu, clique em Add Custom Action.

  3. No Selecione o item no projeto caixa de diálogo, clique duas vezes o A pasta de aplicativo.

  4. Selecione saída primária do PassData (ativo) para adicionar ação personalizada PassData para o nó de instalação.

  5. No Propriedades janela, selecione o CustomActionData propriedade e o tipo de /mensagens = "[mensagem]".

  6. Certifique-se a InstallerClass for definida como True (Este é o padrão).

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

  1. Selecione o projeto de instalação em Solution Explorer. Sobre o Exibir , aponte para Editore, em seguida, clique em Interface do usuário.

  2. No User Interface Editor, selecione o Iniciar nó em instalar. Sobre o ação menu, clique em Caixa de diálogo Adicionar.

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

  4. Sobre o ação menu, clique em Mover para cima. Repita até que o Caixas de texto (A) caixa de diálogo está acima de A pasta de instalação nó.

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

    Qual é a sua mensagem?

  6. Selecione o corpodetexto propriedade e digite:

    Digite sua mensagem aqui.

  7. Selecione o Edit1Label propriedade e digite:

    Mensagem:

  8. Selecione o Edit1Property propriedade e digite:

    MENSAGEM

  9. Selecione o Edit2Visible, Edit3Visible, e Edit4Visible propriedades e defini-los como False.

  10. No Build menu, clique em Criar instalador de dados de passar.

Para instalar em seu computador de desenvolvimento

  • Selecione o passdata Installer projeto em Solution Explorer. Sobre o projeto menu, clique em instalar.

    Isso irá executar o instalador em seu computador de desenvolvimento. No o que é a sua mensagem? caixa de diálogo de instalação, o tipo de Hello World!.

    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 Windows Explorer, navegue até o diretório de projeto e localizar o instalador integrado. O padrão configuração de projeto é Debug ou Release.

  2. Copie todos os Installer.msi de PassData, 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.

    No computador de destino, clique duas vezes em Setup. exe para executar o instalador. No o que é a sua mensagem? caixa de diálogo de instalação, o tipo de Hello World!.

    ObservaçãoObservação

    Você deve ter as permissões de instalação 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 O painel de controle, clique duas vezes em Adicionar ou remover programas ou programas e recursos.

  2. Selecione passdata Installer e clique em Remover ou desinstalar, em seguida, clique em OK para fechar a caixa de diálogo.

    Dica

    Para desinstalar o seu computador de desenvolvimento na projeto menu, clique em desinstalar.

Consulte também

Referência

Propriedade CustomActionData

Outros recursos

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