Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Aktion

Aktualisiert: November 2007

Im Folgenden wird exemplarisch die Vorgehensweise beim Erstellen einer benutzerdefinierten DLL-Aktion beschrieben, die einen Benutzer nach Abschluss einer Installation auf eine Webseite leitet.

Hinweis:

Die angezeigten Dialogfelder und Menübefehle können sich je nach den aktiven Einstellungen oder der verwendeten Version 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 Anweisungen wird ein Visual Basic-Projekt als Beispiel verwendet, um das Erstellen einer Bereitstellung zu erläutern. Die allgemeinen Prinzipien gelten für Visual Studio-Projekte in allen Programmiersprachen, die das Bereitstellen von Windows-basierten Anwendungen unterstützen.

So erstellen Sie die benutzerdefinierte Aktion

  1. Klicken Sie im Menü Datei auf Neues Projekt.

  2. Wählen Sie im Dialogfeld Neues Projekt im Bereich Projekttyp den Eintrag Visual Basic-Projekte aus, und klicken Sie dann im Bereich Vorlagen auf Klassenbibliothek. Geben Sie im Feld Name die Zeichenfolge OpenWeb ein.

    Das Projekt wird zum Projektmappen-Explorer hinzufügt.

  3. Klicken Sie im Menü Projekt auf Klasse hinzufügen, und wählen Sie dann im Dialogfeld Neues Element hinzufügen die Option Installerklasse aus. Übernehmen Sie den Standardnamen Installer1.vb. Klicken Sie auf Hinzufügen.

  4. Schalten Sie in die Codeansicht um, indem Sie entweder auf der Entwurfsoberfläche auf klicken Sie hier, um zur Codeansicht zu wechseln klicken (oder indem Sie mit der rechten Maustaste auf die Entwurfsoberfläche klicken und Code anzeigen auswählen).

  5. Fügen Sie Installer1.vb im Code-Editor den folgenden Code (der einen Webbrowser öffnet) unterhalb des Konstruktors hinzu:

    <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> _
    Public Overrides Sub Commit(ByVal savedState As _
      System.Collections.IDictionary)
    
      MyBase.Commit(savedState)
      System.Diagnostics.Process.Start("https://www.microsoft.com")
    End Sub
    
    Hinweis:

    Wenn Sie Public Overrides und danach ein Leerzeichen eingeben, zeigt Intellisense eine Liste mit Methoden und Eigenschaften an. Wenn Sie in der Liste beispielsweise Commit auswählen, erhalten Sie die vollständige Deklaration.

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Class1.vb, und klicken Sie dann auf Löschen (da Class1.vb nicht benötigt wird).

So fügen Sie ein Bereitstellungsprojekt hinzu

  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, und wählen Sie dann Setup- und Bereitstellungsprojekte aus. Klicken Sie im Bereich Vorlagen auf Setup-Projekt. Geben Sie im Feld Name die Zeichenfolge Custom Action Installer ein.

    Das Projekt wird zum Projektmappen-Explorer hinzugefügt, und der Dateisystem-Editor wird geöffnet.

  3. Wählen Sie im Dateisystem-Editor den Anwendungsordner im linken Bereich aus. Zeigen Sie im Menü Aktion auf Hinzufügen, und klicken Sie dann auf Projektausgabe.

  4. Im Dialogfeld Projektausgabegruppe hinzufügen wird OpenWeb in der Liste Projekt angezeigt. Wählen Sie Primäre Ausgabe aus.

    Im Anwendungsordner wird Primäre Ausgabe von OpenWeb (aktiv) angezeigt.

So fügen Sie die benutzerdefinierte Aktion hinzu

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

    Der Editor für benutzerdefinierte Aktionen wird angezeigt.

  2. Wählen Sie im Editor für benutzerdefinierte Aktionen den Knoten Commit ausführen 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 Primäre Ausgabe aus OpenWeb aus.

    Primäre Ausgabe von OpenWeb wird unter dem Knoten Commit ausführen im Editor für benutzerdefinierte Aktionen angezeigt.

  4. Stellen Sie im Eigenschaftenfenster sicher, dass die InstallerClass-Eigenschaft auf True festgelegt ist (dies ist die Standardeinstellung).

  5. Wählen Sie im Editor für benutzerdefinierte Aktionen den Knoten Installieren aus, und fügen Sie den Knoten Primäre Ausgabe von OpenWeb hinzu, indem Sie genauso vorgehen wie für den Knoten Commit ausführen.

  6. Klicken Sie im Menü Erstellen auf Custom Action Installer erstellen.

So installieren Sie auf dem Entwicklungscomputer

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

    Dadurch wird das Installationsprogramm ausgeführt und das Benutzerdefinierte Aktion-Installationsprogramm auf dem Entwicklungscomputer installiert. Am Ende der Installation sollte Internet Explorer gestartet und die Website Microsoft.com geöffnet werden.

    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\Projects\Custom Action Installer\Custom Action Installer\Projektkonfiguration\Custom Action Installer.msi. Die vorgegebene Projektkonfiguration lautet Debug.

  2. Kopieren Sie Benutzerdefinierte Aktion-Installationsprogramm.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.

  3. Doppelklicken Sie auf dem Zielcomputer auf die Datei Setup.exe, um das Installationsprogramm auszuführen.

    Am Ende der Installation sollte Internet Explorer gestartet und die Website Microsoft.com geöffnet werden.

    Hinweis:

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

    Hinweis:

    Wenn .NET Framework auf dem Zielcomputer noch nicht installiert ist, wird es mit dieser Bereitstellung installiert. Dies kann einige Minuten dauern.

So deinstallieren Sie die Anwendung

  1. Doppelklicken Sie in der Systemsteuerung auf Software.

  2. Wählen Sie im Dialogfeld Software die Anwendung Custom Action Installer aus, und klicken Sie auf Entfernen.

    Tipp:

    Um die Anwendung vom Entwicklungscomputer zu deinstallieren, öffnen Sie das Projekt Custom Action Installer, wählen es im Projektmappen-Explorer aus und klicken im Menü Projekt auf Deinstallieren.

Siehe auch

Konzepte

Benutzerdefinierte Aktionen

Weitere Ressourcen

Verwalten von benutzerdefinierten Aktionen bei der Bereitstellung