ServiceInstaller.Install-Methode

Installiert den Dienst, indem Dienstanwendungsdaten in die Registrierung geschrieben werden. Diese Methode ist nur für die Verwendung durch Installationstools vorgesehen, die die entsprechenden Methoden automatisch verarbeiten.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

Syntax

'Declaration
Public Overrides Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As ServiceInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

public override void Install (
    IDictionary stateSaver
)

public:
virtual void Install (
    IDictionary^ stateSaver
) override

public void Install (
    IDictionary stateSaver
)

public override function Install (
    stateSaver : IDictionary
)

Parameter

• stateSaver
  Ein IDictionary mit Kontextinformationen für die Installation.

Ausnahmen

Ausnahmetyp	Bedingung
Exception	Die Installation enthält keinen ServiceProcessInstaller für die ausführbare Datei. - oder - Die zu installierende Assembly wurde nicht gefunden. - oder - Der Dienstname ist ungültig. - oder - Der Dienststeuerungs-Manager konnte nicht geöffnet werden.
Win32Exception	Das System konnte kein Handle für den Dienst generieren.

Hinweise

Normalerweise rufen Sie die Methoden für ServiceInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsdienstprogramm aufgerufen. Das Installationsprogramm ruft bei der Installation automatisch die Install-Methode auf. Im Bedarfsfall werden Fehler behoben, indem Rollback für das Objekt aufgerufen wird, das die Ausnahme generiert hat.

Die Installationsroutine einer Anwendung verwaltet automatisch Informationen über bereits installierte Komponenten. Dazu wird der Installer.Context des Projektinstallationsprogramms verwendet. Diese Zustandsinformationen, die als stateSaver-Parameter an Install übergeben werden, werden fortlaufend aktualisiert, während das Dienstprogramm die ServiceProcessInstaller-Instanz und alle ServiceInstaller-Instanzen installiert. Normalerweise ist es nicht erforderlich, dass der Code diese Zustandsinformationen explizit ändert.

Der ServiceProcessInstaller der Projektinstallationsklasse installiert Informationen, die zu allen ServiceInstaller-Instanzen des Projekts gehören. Wenn sich der Dienst von den anderen Diensten im Installationsprojekt unterscheidet, wird diese Methode zur Installation der dienstspezifischen Informationen verwendet.

Erstellen Sie zum Installieren eines Dienstes eine Projektinstallationsprogramm-Klasse, die von der Installer-Klasse erbt, und legen Sie das RunInstallerAttribute-Attribute für die Klasse auf true fest. Erstellen Sie für jede Dienstanwendung im Projekt eine ServiceProcessInstaller-Instanz und für jeden Dienst in der Anwendung jeweils eine ServiceInstaller-Instanz. Legen Sie die Installationseigenschaften für den Dienst im Klassenkonstruktor des Projektinstallationsprogramms mithilfe der ServiceProcessInstaller-Instanz und der ServiceInstaller-Instanz fest, und fügen Sie die Instanzen der Installers-Auflistung hinzu.

Hinweis

   Es ist empfehlenswert, dass Sie den Konstruktor verwenden, um die Instanzen des Installationsprogramms hinzuzufügen. Wenn das Hinzufügen zur Installers-Auflistung jedoch in der Install-Methode erfolgen soll, stellen Sie sicher, dass Sie der Auflistung in der Uninstall-Methode dieselben Elemente hinzufügen.

Für alle von der Installer-Klasse abgeleiteten Klassen muss der Zustand der Installers-Auflistung in der Install-Methode und in der Uninstall-Methode übereinstimmen. Sie können es jedoch vermeiden, die Auflistung in der Install-Methode und in der Uninstall-Methode in Übereinstimmung halten zu müssen, indem Sie der Installers-Auflistung im Klassenkonstruktor für das benutzerdefinierte Installationsprogramm Instanzen des Installationsprogramms hinzufügen.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ServiceInstaller-Klasse
ServiceInstaller-Member
System.ServiceProcess-Namespace
ServiceProcessInstaller
Rollback
Installer.Commit
Uninstall
EventLogInstaller
EventLogInstaller