Installer.Install-Methode

Artikel
08/20/2007

Führt beim Überschreiben in einer abgeleiteten Klasse die Installation aus.

Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Overridable Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As Installer
Dim stateSaver As IDictionary

instance.Install(stateSaver)

public virtual void Install (
    IDictionary stateSaver
)

public:
virtual void Install (
    IDictionary^ stateSaver
)

public void Install (
    IDictionary stateSaver
)

public function Install (
    stateSaver : IDictionary
)

Parameter

stateSaver
Ein IDictionary, in dem die zum Ausführen eines Commit-, Rollback- oder Deinstallationsvorgangs erforderlichen Daten gespeichert werden.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der stateSaver-Parameter ist NULL (Nothing in Visual Basic).
Exception	Im BeforeInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten. – oder – Im AfterInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

ArgumentException

Der stateSaver-Parameter ist NULL (Nothing in Visual Basic).

Exception

Im BeforeInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

– oder –

Im AfterInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

Hinweise

Hinweise für Erben Wenn Sie die Install-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie in der abgeleiteten Methode unbedingt zuerst die Install-Methode der Basisklasse aufrufen. Die Install-Methode ruft die Install-Methode für alle Installationsprogramme in der Installers-Eigenschaft dieser Instanz auf. Nachdem die enthaltenen Installationsprogramme ausgeführt wurden, wird mit dieser Methode das IDictionary-Objekt, das durch den stateSaver-Parameter festgelegt ist, aktualisiert und somit der Zustand der Installation wiedergegeben. Das IDictionary sollte bei der Übergabe an die Install-Methode leer sein. Wenn alle Install-Methoden ordnungsgemäß ausgeführt wurden, wird die Commit-Methode aufgerufen. Andernfalls wird die Rollback-Methode aufgerufen.

Beispiel

Das folgende Beispiel veranschaulicht die Install-Methode der Installer-Klasse. Eine Klasse wird von der Installer-Basisklasse abgeleitet, und die Install-Methode wird überschrieben.

' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState As IDictionary)
   MyBase.Install(mySavedState)
   ' Code maybe written for installation of an application.
   Console.WriteLine("The Install method of 'MyInstallerSample' has been called")
End Sub 'Install

// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState )
{
   base.Install( mySavedState );
   // Code maybe written for installation of an application.
   Console.WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}

   // Override the 'Install' method of the Installer class.
public:
   virtual void Install( IDictionary^ mySavedState ) override
   {
      Installer::Install( mySavedState );
      // Code maybe written for installation of an application.
      Console::WriteLine( "The Install method of 'MyInstallerSample' has been called" );
   }

// Override the 'Install' method of the Installer class.
public void Install(IDictionary mySavedState)
{
    super.Install(mySavedState);

    // Code maybe written for installation of an application.
    Console.WriteLine("The Install method of"
        +" 'MyInstallerSample' has been called");
} //Install

.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 Millennium Edition, 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

Installer-Klasse
Installer-Member
System.Configuration.Install-Namespace
Commit
IDictionary
InstallerCollection
Installers
Rollback
Uninstall

Freigeben über