Freigeben über


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

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

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

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

  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 Fenster Eigenschaften 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 aus PassData (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.

  4. Wählen Sie Primäre Ausgabe aus PassData (Aktiv) aus, um dem Knoten Installieren die benutzerdefinierte Aktion PassData hinzuzufügen.

  5. Wählen Sie im Eigenschaftenfenster die CustomActionData-Eigenschaft aus, und geben Sie /Message="[MESSAGE]" ein.

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

    Tipp

    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 nach dem erstellten Installer. 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.

    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

  1. Doppelklicken Sie in der Systemsteuerung von Windows auf Software oder Programme und Funktionen.

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

Siehe auch

Referenz

CustomActionData-Eigenschaft

Weitere Ressourcen

Verwalten von benutzerdefinierten Aktionen bei der Bereitstellung