Gewusst wie: Hinzufügen von Installern zur Dienstanwendung

Artikel
09/02/2008

Aktualisiert: November 2007

Im Lieferumfang von Visual Studio sind Installationskomponenten enthalten, mit denen Ressourcen installiert werden können, die Dienstanwendungen zugeordnet sind. Von Installationskomponenten wird ein einzelner Dienst auf dem System registriert, auf dem er installiert wird. Dem Dienststeuerungs-Manager wird mitgeteilt, dass der Dienst vorhanden ist. Wenn mit einer Dienstanwendung gearbeitet wird, können die entsprechenden Installationsprogramme über einen Hyperlink im Eigenschaftenfenster dem Projekt hinzugefügt werden. Weitere Informationen über Installationskomponenten und deren Funktionsweise finden Sie unter Einführung in Installationskomponenten.

Hinweis:
Eigenschaftenwerte für einen Dienst werden aus der Dienstklasse in die Installerklasse kopiert. Wenn Eigenschaftenwerte in der Dienstklasse aktualisiert werden, werden sie nicht automatisch im Installationsprogramm aktualisiert.

Wenn einem Projekt ein Installationsprogramm hinzugefügt wird, wird eine neue Klasse im Projekt erstellt, die den Standardnamen ProjectInstaller aufweist. In ihr werden Instanzen der entsprechenden Installationskomponenten erstellt. Diese Klasse fungiert als zentraler Punkt für alle Installationskomponenten, die für das Projekt benötigt werden. Wenn z. B. ein zweiter Dienst zur Anwendung hinzugefügt und auf den Link Installer hinzufügen geklickt wird, wird keine zweite Installationsprogrammklasse erstellt. Stattdessen werden die für den zweiten Dienst benötigten zusätzlichen Installationskomponenten zur vorhandenen Klasse hinzugefügt.

Innerhalb der Installationsprogramme wird keine besondere Codierung für die richtige Installation von Diensten benötigt. Es kann jedoch durchaus notwendig werden, die Inhalte von Installationsprogrammen zu ändern, wenn spezielle Funktionen zum Installationsvorgang hinzugefügt werden müssen. Weitere Informationen finden Sie unter Gewusst wie: Konfigurieren von Installationskomponenten.

Wenn Sie der Anwendung Installationsprogramme hinzugefügt haben, erstellen Sie im nächsten Schritt ein Setup-Projekt, mit dem die kompilierten Projektdateien installiert und die zum Installieren des Diensts benötigten Installationsprogramme ausgeführt werden. Zum Erstellen eines vollständigen Setup-Projekts müssen Sie die Ausgabe des Dienstprojekts zum Setup-Projekt hinzufügen und dann eine benutzerdefinierte Aktion einfügen, um den Dienst zu installieren. Weitere Informationen über Setup-Projekte finden Sie unter Setup-Projekte. Weitere Informationen über benutzerdefinierte Aktionen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Aktion.

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

So fügen Sie Installationsprogramme zu Dienstanwendungen hinzu

Öffnen Sie im Projektmappen-Explorer die Entwurfsansicht für den Dienst, dem eine Installationskomponente hinzugefügt werden soll.
Klicken Sie auf den Hintergrund des Designers, um den Dienst selbst, nicht aber den Inhalt zu markieren.
Klicken Sie mit der rechten Maustaste, wenn der Designer den Fokus hat, und klicken Sie dann auf Installer hinzufügen.

Eine neue Klasse, ProjectInstaller, und zwei Installationskomponenten, ServiceProcessInstaller und ServiceInstaller, werden dem Projekt hinzugefügt. Außerdem werden Eigenschaftenwerte für den Dienst in die Komponenten kopiert.
Klicken Sie auf die ServiceInstaller-Komponente. Überprüfen Sie, ob die ServiceName-Eigenschaft auf den gleichen Wert festgelegt ist wie die ServiceName-Eigenschaft für den Dienst selbst.

Legen Sie fest, wie der Dienst gestartet wird, indem Sie auf die ServiceInstaller-Komponente klicken und die StartType-Eigenschaft auf den entsprechenden Wert festlegen.

Wert	Ergebnis
Manual	Der Dienst muss nach der Installation manuell gestartet werden. Weitere Informationen finden Sie unter Gewusst wie: Starten von Diensten.
Automatic	Der Dienst wird eigenständig gestartet, wenn der Computer neu gestartet wird.
Disabled	Der Dienst kann nicht gestartet werden.

Legen Sie den Sicherheitskontext fest, in dem ein Dienst ausgeführt wird, indem Sie auf die ServiceProcessInstaller-Komponente klicken und die entsprechenden Eigenschaftenwerte festlegen. Weitere Informationen finden Sie unter Gewusst wie: Angeben des Sicherheitskontexts für Dienste.
Überschreiben Sie alle Methoden, für die eine benutzerdefinierte Verarbeitung durchgeführt werden muss. Weitere Informationen finden Sie unter Gewusst wie: Überschreiben von Standardmethoden bei Installationskomponenten.

Führen Sie die Schritte 1 bis 7 für jeden zusätzlichen Dienst in dem Projekt durch.

Hinweis:
Für jeden zusätzlichen Dienst im Projekt muss der ProjectInstaller-Klasse des Projekts eine zusätzliche ServiceInstaller-Komponente hinzugefügt werden. Die in Schritt 3 hinzugefügte ServiceProcessInstaller-Komponente funktioniert mit allen Dienstinstallern im Projekt.

Erstellen Sie das Setup-Projekt und die benutzerdefinierte Aktion, um den Dienst bereitzustellen und zu installieren. Weitere Informationen über Setup-Projekte finden Sie unter Setup-Projekte. Weitere Informationen über benutzerdefinierte Aktionen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Aktion.