ServiceProcessInstaller.Install-Methode

Artikel
08/20/2007

Schreibt Dienstanwendungsinformationen in die Registrierung. Diese Methode ist für die Verwendung durch Installationstools bestimmt, die die entsprechenden Methoden automatisch aufrufen.

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

Syntax

'Declaration
Public Overrides Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As ServiceProcessInstaller
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
ArgumentException	Der stateSaver ist NULL (Nothing in Visual Basic).

Hinweise

Normalerweise rufen Sie die Methoden für ServiceProcessInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsdienstprogramm aufgerufen. Das Installationsdienstprogramm ruft bei der Installation automatisch die ServiceProcessInstaller.Install-Methode auf. Im Bedarfsfall werden Fehler behoben, indem Rollback für alle zuvor installierten Komponenten aufgerufen wird. Diese Methode übergibt die Installation an die Installer.Install-Methode der Basisklasse.

Normalerweise rufen Sie die Methoden für ServiceInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsdienstprogramm aufgerufen. Das Installationsdienstprogramm ruft die ServiceProcessInstaller.Install-Methode und die ServiceInstaller.Install-Methode bei der Installation automatisch auf. Im Bedarfsfall werden Fehler behoben, indem Rollback oder ServiceInstaller.Rollback für alle zuvor installierten Komponenten aufgerufen wird.

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.

Install übergibt alle Ausnahmen, die von Basisklassenmethoden oder BeforeInstall-Ereignishandlern und AfterInstall-Ereignishandlern ausgelöst werden, an die aufrufende Methode.

.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

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

Freigeben über