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

Aktualisiert: November 2007

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.

Hinweis:
Je nach den aktiven Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen hierzu finden Sie unter Visual Studio-Einstellungen.

Hinweis:
In den folgenden Schritten wird die Erstellung eines Bereitstellungsprojekts mithilfe eines Visual Basic-Projekts beschrieben; die allgemeinen Prinzipien gelten für alle Visual Studio-Sprachprojekte, die die Bereitstellung von Windows-Anwendungen unterstützen.

So erstellen Sie eine benutzerdefinierte Aktion

1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

2. 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

1. 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.

2. 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.

3. Fügen Sie die folgende Prozedur hinzu, um die Install-Prozedur der Basisklasse aufzuheben:

   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
   

   Hinweis:
   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.

4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Class1.vb, und wählen Sie Löschen aus (da Class1.vb unnötig ist).

So erstellen Sie ein Bereitstellungsprojekt

1. Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.

2. Ö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.

3. Wählen Sie im Eigenschaftenfenster die ProductName-Eigenschaft aus, und geben Sie PassData ein.

   Wählen Sie die Manufacturer-Eigenschaft aus, und geben Sie My Company ein.

4. Markieren Sie im Dateisystem-Editor den Knoten Anwendungsordner. Zeigen Sie im Menü Aktion auf Hinzufügen, und klicken Sie dann auf Projektausgabe.

5. Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen die primäre Ausgabe für das PassData-Projekt.

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

So fügen Sie eine benutzerdefinierte Aktion hinzu

1. Wählen Sie das PassData Installer-Projekt im Projektmappen-Explorer aus. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie auf Benutzerdefinierte Aktionen.

2. Wählen Sie im Editor für benutzerdefinierte Aktionen den (oberen) Knoten Installieren aus. Klicken Sie im Menü Aktion auf Benutzerdefinierte Aktion hinzufügen.

3. Doppelklicken Sie im Dialogfeld Element im Projekt auswählen auf den Anwendungsordner.

   Wählen Sie das Element Primäre Ausgabe aus PassData (Aktiv). Dadurch wird der benutzerdefinierten Aktion PassData der Knoten Installieren hinzugefügt.

4. 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

1. Markieren Sie das Setup-Projekt im Projektmappen-Explorer. Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie anschließend auf Benutzeroberfläche.

2. Wählen Sie im Benutzeroberflächen-Editor unter Installieren den Knoten Start aus. Klicken Sie im Menü Aktion auf Dialogfeld hinzufügen.

3. Wählen Sie im Dialogfeld Dialogfeld hinzufügen das Dialogfeld Textfelder (A) aus.

4. Klicken Sie im Menü Aktion auf Nach oben. Wiederholen Sie diesen Vorgang, bis sich das Dialogfeld Textfelder (A) oberhalb des Knotens Installationsordner befindet.

5. Wählen Sie im Eigenschaftenfenster die BannerText-Eigenschaft aus, und geben Sie Folgendes ein:

   What is your message?

6. Wählen Sie die BodyText-Eigenschaft aus, und geben Sie Folgendes ein:

   Enter your message here.

7. Wählen Sie die Edit1Label-Eigenschaft, und geben Sie Folgendes ein:

   Message:

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

   MESSAGE

9. Legen Sie die Eigenschaften Edit2Visible, Edit3Visible und Edit4Visible auf False fest.

10. 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.

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

So geben Sie an einen anderen Computer weiter

1. Navigieren Sie in Windows Explorer zu dem Projektverzeichnis, und suchen Sie das erstellte Installationsprogramm. Der Standardpfad lautet \Dokumente und Einstellungen\Ihr Anmeldename\Eigene Dateien\Visual Studio 2005\Projects\Name des Projektmappenordners\My Notepad Installer\Projektkonfiguration\My Notepad Installer.msi. Die standardmäßige Projektkonfiguration> lautet entweder Debug oder Release.

2. Kopieren Sie PassData Installer.msi, Setup.exe und alle anderen Dateien und Unterverzeichnisse im Verzeichnis auf einen anderen Computer.

   Hinweis:
   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.

   Hinweis:
   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

1. Doppelklicken Sie in der Windows-Systemsteuerung auf das Symbol Software.

2. Wählen Sie im Dialogfeld Software die Option PassData Installer aus, und klicken Sie auf Entfernen. Klicken Sie anschließend auf OK, um das Dialogfeld zu schließen.

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

Siehe auch

Referenz

CustomActionData-Eigenschaft

Weitere Ressourcen

Verwalten von benutzerdefinierten Aktionen bei der Bereitstellung

Verwenden von Installationskomponenten