Freigeben über


Installer.OnBeforeInstall-Methode

Löst das BeforeInstall-Ereignis aus.

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

Syntax

'Declaration
Protected Overridable Sub OnBeforeInstall ( _
    savedState As IDictionary _
)
'Usage
Dim savedState As IDictionary

Me.OnBeforeInstall(savedState)
protected virtual void OnBeforeInstall (
    IDictionary savedState
)
protected:
virtual void OnBeforeInstall (
    IDictionary^ savedState
)
protected void OnBeforeInstall (
    IDictionary savedState
)
protected function OnBeforeInstall (
    savedState : IDictionary
)

Parameter

  • savedState
    Ein IDictionary mit dem Zustand, in dem sich der Computer befindet, bevor die Installationsprogramme in der Installers-Eigenschaft installiert werden. Dieses IDictionary-Objekt sollte zu diesem Zeitpunkt leer sein.

Hinweise

Diese Methode wird aufgerufen, bevor die Install-Methoden der Installationsprogramme in der InstallerCollection dieser Instanz aufgerufen werden.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.

Die OnBeforeInstall-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Erben Wenn Sie OnBeforeInstall in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnBeforeInstall-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.

Beispiel

Das folgende Beispiel veranschaulicht die OnBeforeInstall-Methode. Diese Methode wird in der abgeleiteten Klasse überschrieben. Am vorgesehenen Ort können Schritte hinzugefügt werden, die vor der Installation in der OnBeforeInstall-Methode ausgeführt werden müssen.

' Override the 'OnBeforeInstall' method.
Protected Overrides Sub OnBeforeInstall(savedState As IDictionary)
   MyBase.OnBeforeInstall(savedState)
   ' Add steps to be done before the installation starts.
   Console.WriteLine("OnBeforeInstall method of MyInstaller called")
End Sub 'OnBeforeInstall
// Override the 'OnBeforeInstall' method.
protected override void OnBeforeInstall(IDictionary savedState)
{
   base.OnBeforeInstall(savedState);
   // Add steps to be done before the installation starts.
   Console.WriteLine("OnBeforeInstall method of MyInstaller called");
}
   // Override the 'OnBeforeInstall' method.
protected:
   virtual void OnBeforeInstall( IDictionary^ savedState ) override
   {
      Installer::OnBeforeInstall( savedState );
      
      // Add steps to be done before the installation starts.
      Console::WriteLine( "OnBeforeInstall method of MyInstaller called" );
   }
// Override the 'OnBeforeInstall' method.
protected void OnBeforeInstall(IDictionary savedState)
{
    super.OnBeforeInstall(savedState);

    // Add steps to be done before the installation starts.
    Console.WriteLine("OnBeforeInstall method of MyInstaller called");
} //OnBeforeInstall

.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
OnAfterInstall
OnAfterRollback
OnAfterUninstall
OnCommitting
OnCommitted
OnBeforeRollback
OnBeforeUninstall