Exemplarische Vorgehensweise: Anzeigen einer Meldung bei der Installation mithilfe einer benutzerdefinierten Aktion

Artikel
08/10/2011

Durch die folgende exemplarische Vorgehensweise wird erläutert, wie mit einem benutzerdefinierten Vorgang Benutzereingaben an ein Meldungsfeld übergeben werden, das während der Installation angezeigt wird. Dies ist eine einfache Demonstration benutzerdefinierter Aktionen, die für viele andere Aufgaben hilfreich sind. Ein benutzerdefinierter Vorgang kann beispielweise den Speicherort der Datei Setup.exe als Benutzereingabe akzeptieren und diesen zum Starten der Anwendung nach der Installation verwenden.

In dieser exemplarischen Vorgehensweise wird erläutert, wie Daten mit einem benutzerdefinierten Vorgang an eine dynamische Eigenschaft übergeben werden und wie eine Installerklasse und die CustomActionData-Eigenschaft verwendet werden.

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

So erstellen Sie eine benutzerdefinierte Aktion

Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt aus dem Bereich Projekttypen den Eintrag Visual Basic. Wählen Sie anschließend aus dem Bereich Vorlagen den Eintrag Klassenbibliothek. Geben Sie im Feld Name die Zeichenfolge PassData ein.

Das Projekt wird zum Projektmappen-Explorer hinzufügt.

So erstellen Sie eine Installationsprogrammklasse

Klicken Sie im Menü Projekt auf Klasse hinzufügen.

Wählen Sie im Dialogfeld Neues Element hinzufügen den Eintrag Installerklasse. Übernehmen Sie den Standardnamen.
Wenn die Installerklasse in der Entwurfsoberfläche angezeigt wird, klicken Sie mit der rechten Maustaste in die Entwurfsoberfläche. Klicken Sie anschließend auf Code anzeigen, um den Inhalt der Datei im Code-Editor anzuzeigen.

Fügen Sie die folgende Prozedur hinzu, um die Prozeduren Install, Commit, Rollback und Uninstall der Basisklasse zu überschreiben.

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);
}

Tipp

Wenn Sie Public Overrides und danach einen Leerschritt eingeben, zeigt Intellisense eine Liste mit Methoden und Eigenschaften an; wenn Sie beispielsweise Installieren aus dieser Liste auswählen, erhalten Sie die vollständige Deklaration.

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Class1-Codedatei, und wählen Sie Löschen aus (da die Datei nicht benötigt wird).

So erstellen Sie ein Bereitstellungsprojekt

Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.
Öffnen Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Projekttyp den Knoten Andere Projekttypen. Klicken Sie dann auf Setup- und Bereitstellungsprojekte und anschließend im Bereich Vorlagen auf Setup-Projekt. Geben Sie im Feld Name die Zeichenfolge "PassData Installer" ein.
Wählen Sie im Fenster Eigenschaften die ProductName-Eigenschaft aus, und geben Sie "PassData" ein.

Wählen Sie die Manufacturer-Eigenschaft aus, und geben Sie "My Company" ein.
Markieren Sie im Dateisystem-Editor den Knoten Anwendungsordner. Zeigen Sie im Menü Aktion auf Hinzufügen, und klicken Sie dann auf Projektausgabe.
Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen die primäre Ausgabe für das PassData-Projekt.

Im Dateisystem-Editor wird Primäre Ausgabe aus PassData (Aktiv) angezeigt.

So fügen Sie eine benutzerdefinierte Aktion hinzu

Wählen Sie das PassData Installer-Projekt im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie auf Benutzerdefinierte Aktionen.
Wählen Sie im Editor für benutzerdefinierte Aktionen den (oberen) Knoten Installieren aus. Klicken Sie im Menü Aktion auf Benutzerdefinierte Aktion hinzufügen.
Doppelklicken Sie im Dialogfeld Element im Projekt auswählen auf den Anwendungsordner.
Wählen Sie Primäre Ausgabe aus PassData (Aktiv) aus, um dem Knoten Installieren die benutzerdefinierte Aktion PassData hinzuzufügen.
Wählen Sie im Eigenschaftenfenster die CustomActionData-Eigenschaft aus, und geben Sie /Message="[MESSAGE]" ein.
Stellen Sie sicher, dass für die InstallerClass-Eigenschaft der Standardwert True festgelegt ist.

So passen Sie die Benutzeroberfläche der Installation an

Markieren Sie das Setup-Projekt im Projektmappen-Explorer. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie anschließend auf Benutzeroberfläche.
Wählen Sie im Benutzeroberflächen-Editor unter Installieren den Knoten Start aus. Klicken Sie im Menü Aktion auf Dialogfeld hinzufügen.
Wählen Sie im Dialogfeld Dialogfeld hinzufügen das Dialogfeld Textfelder (A) aus.
Klicken Sie im Menü Aktion auf Nach oben. Wiederholen Sie diesen Vorgang, bis sich das Dialogfeld Textfelder (A) oberhalb des Knotens Installationsordner befindet.
Wählen Sie im Eigenschaftenfenster die BannerText-Eigenschaft aus, und geben Sie Folgendes ein:

What is your message?
Wählen Sie die BodyText-Eigenschaft aus, und geben Sie Folgendes ein:

Enter your message here.
Wählen Sie die Edit1Label-Eigenschaft, und geben Sie Folgendes ein:

Message:
Wählen Sie die Edit1Property-Eigenschaft, und geben Sie Folgendes ein:

MESSAGE
Legen Sie die Eigenschaften Edit2Visible, Edit3Visible und Edit4Visible auf False fest.
Klicken Sie im Menü Erstellen auf PassData-Installationsprogramm erstellen.

So installieren Sie auf dem Entwicklungscomputer

Wählen Sie das PassData Installer-Projekt im Projektmappen-Explorer aus. Klicken Sie im Menü Projekt auf Installieren.

Dadurch wird das Installationsprogramm auf dem Entwicklungscomputer ausgeführt. Geben Sie im Installationsdialogfeld What is your Message? die Zeichenfolge Hello World! ein..

Tipp

Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

So geben Sie an einen anderen Computer weiter

Navigieren Sie in Windows Explorer zu dem Projektverzeichnis, und suchen Sie nach dem erstellten Installer. Die standardmäßige Projektkonfiguration> lautet entweder Debug oder Release.
Kopieren Sie PassData Installer.msi, Setup.exe und alle anderen Dateien und Unterverzeichnisse im Verzeichnis auf einen anderen Computer.

Tipp

Wenn Sie die Installation auf einem Computer durchführen möchten, der nicht mit einem Netzwerk verbunden ist, kopieren Sie die Dateien auf ein Medium, beispielsweise eine CD-ROM.

Doppelklicken Sie auf dem Zielcomputer auf die Datei Setup.exe, um das Installationsprogramm auszuführen. Geben Sie im Installationsdialogfeld What is your Message? die Zeichenfolge Hello World! ein..

Tipp

Zum Ausführen des Installationsprogramms benötigen Sie entsprechende Installationsberechtigungen für den Computer.

So testen Sie die Installation

Führen Sie die Anwendung aus, und stellen Sie sicher, dass das Textfeld den Eintrag "Hello World!" enthält, der während der Installation eingegeben wurde.

So deinstallieren Sie die Anwendung

Doppelklicken Sie in der Systemsteuerung von Windows auf Software oder Programme und Funktionen.
Wählen Sie PassData Installer aus, und klicken Sie auf Entfernen oder Deinstallieren und dann auf OK, um das Dialogfeld zu schließen.

Tipp

Für die Deinstallation auf dem Entwicklungscomputer klicken Sie im Menü Projekt auf Deinstallieren.