Procedura dettagliata: utilizzo di un'azione personalizzata per visualizzare un messaggio durante l'installazione

Articolo
08/11/2011

Nella seguente procedura dettagliata viene illustrato come utilizzare un'azione personalizzata per ottenere l'input dell'utente e passarlo a una finestra di messaggio che verrà visualizzata durante l'installazione. Si tratta di una semplice dimostrazione dell'utilizzo di azioni personalizzate, utili per molte altre attività. Mediante un'azione personalizzata, ad esempio, è possibile accettare come input dell'utente il percorso del file Setup.exe e utilizzarlo per avviare l'applicazione dopo l'installazione.

In questa procedura dettagliata viene illustrato come passare dati a una proprietà dinamica utilizzando un'azione personalizzata e come utilizzare una classe Installer e la proprietà CustomActionData.

Nota

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Per creare un'azione personalizzata

Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro Tipi progetto della finestra di dialogo Nuovo progetto selezionare Visual Basic, quindi scegliere Libreria di classi nel riquadro Modelli. Nella casella Nome digitare PassData.

Il progetto verrà aggiunto a Esplora soluzioni.

Per creare una classe del programma di installazione

Scegliere Aggiungi classe dal menu Progetto.

Nella finestra di dialogo Aggiungi nuovo elemento scegliere Classe Installer. Accettare il nome predefinito.
Quando la classe Installer viene visualizzata nell'area di progettazione, fare clic con il pulsante destro del mouse sull'area di progettazione e scegliere Visualizza codice per visualizzare il contenuto del file nell'editor del codice.

Aggiungere la procedura seguente per eseguire l'override delle procedure Install, Commit, Rollback and Uninstall della 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);
}

Nota

Se si digita Public Overrides, quindi si immette uno spazio, verrà visualizzato un elenco dei metodi e delle proprietà disponibili. È possibile selezionare Install nell'elenco e ottenere la dichiarazione completa.

In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice Class1 e scegliere Elimina, in quanto non è necessario.

Per creare un progetto di distribuzione

Scegliere Aggiungi dal menu File, quindi Nuovo progetto.
Nel riquadro Tipi progetto della finestra di dialogo Aggiungi nuovo progetto espandere il nodo Altri tipi di progetto, selezionare Installazione e distribuzione, quindi scegliere Progetto di installazione nel riquadro Modelli. Nella casella Nome digitare PassData Installer.
Nella finestra Proprietà selezionare la proprietà ProductName e digitare PassData.

Selezionare inoltre la proprietà Manufacturer e digitare Società.
Nell'Editor del file system selezionare il nodo Cartella Applicazione. Scegliere Aggiungi dal menu Azione, quindi Output progetto.
Nella finestra di dialogo Aggiungi gruppo output progetto selezionare l'output primario per il progetto PassData.

Nell'Editor del file system comparirà Output primario da PassData (Attivo).

Per aggiungere un'azione personalizzata

Selezionare il progetto PassData Installer in Esplora soluzioni. Scegliere Editor dal menu Visualizza, quindi Azioni personalizzate.
Nell'Editor delle azioni personalizzate selezionare il nodo di primo livello Installa. Scegliere Aggiungi azione personalizzata dal menu Azione.
Nella finestra di dialogo Seleziona elemento nel progetto fare doppio clic su Cartella Applicazione.
Selezionare Output primario da PassData (attivo) per aggiungere l'azione personalizzata PassData al nodo Installa.
Nella finestra Proprietà selezionare la proprietà CustomActionData e digitare /Message="[MESSAGE]".
Verificare che la proprietà InstallerClass sia impostata su True (impostazione predefinita).

Per personalizzare l'interfaccia utente dell'installazione

Selezionare il progetto di installazione in Esplora soluzioni. Scegliere Editor dal menu Visualizza, quindi Interfaccia utente.
Nell'Editor dell'interfaccia utente selezionare il nodo Avvio nella sezione Installa. Scegliere Aggiungi finestra di dialogo dal menu Azione.
Nella finestra di dialogo Aggiungi finestra di dialogo selezionare la finestra di dialogo Caselle di testo (A).
Scegliere Sposta su dal menu Azione. Ripetere l'operazione fino a quando la finestra di dialogo Caselle di testo (A) non si trova sopra al nodo Cartella di installazione.
Nella finestra Proprietà selezionare la proprietà BannerText e digitare:

Quale messaggio si desidera specificare?
Selezionare la proprietà BodyText e digitare:

Immettere il messaggio.
Selezionare la proprietà Edit1Label e digitare:

Messaggio:
Selezionare la proprietà Edit1Property e digitare:

MESSAGGIO
Selezionare le proprietà Edit2Visible, Edit3Visible e Edit4Visible e impostarle su False.
Scegliere Compila PassData Installer dal menu Compila.

Per effettuare l'installazione nel computer di sviluppo

Selezionare il progetto PassData Installer in Esplora soluzioni. Scegliere Installa dal menu Progetto.

Il programma di installazione verrà eseguito nel computer di sviluppo. Nella finestra di dialogo di installazione Quale messaggio si desidera specificare? digitare Hello World!..

Nota

Per eseguire il programma di installazione, è necessario disporre delle autorizzazioni di installazione nel computer.

Per effettuare la distribuzione in un altro computer

In Esplora risorse passare alla directory del progetto e trovare il programma di installazione appena compilato. Il valore predefinito di project configuration è Debug oppure Release
Copiare PassData Installer.msi, Setup.exe e tutti gli altri file e sottodirectory della directory in un altro computer.

Nota

Per effettuare l'installazione in un computer non in rete, copiare i file su un supporto tradizionale, ad esempio un CD-ROM.

Nel computer di destinazione fare doppio clic sul file Setup.exe per eseguire il programma di installazione. Nella finestra di dialogo di installazione Quale messaggio si desidera specificare? digitare Hello World!.

Nota

Per eseguire il programma di installazione, è necessario disporre delle autorizzazioni di installazione nel computer.

Per eseguire il test dell'installazione

Eseguire l'applicazione e verificare che la casella di testo contenga il testo 'Hello World!' immesso durante l'installazione.

Per rimuovere l'applicazione

Nel Pannello di controllo di Windows fare doppio clic su Installazione applicazioni o su Programmi e funzionalità.
Selezionare PassData Installer e fare clic su Rimuovi o su Disinstalla, quindi fare clic su OK per chiudere la finestra di dialogo.

Suggerimento

Per eseguire la disinstallazione dal computer di sviluppo, scegliere Disinstalla dal menu Progetto.

Condividi tramite