Installer::OnCommitting Method (IDictionary^)

.NET Framework (current version)

Raises the Committing event.

Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in System.Configuration.Install.dll)

Syntax

C++

protected:
virtual void OnCommitting(
	IDictionary^ savedState
)

Parameters

savedState: Type: System.Collections::IDictionary^
An IDictionary that contains the state of the computer before the installers in the Installers property are committed.

Remarks

This method is called before the Commit methods of the installers in this instance's InstallerCollection run.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnCommitting method allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnCommitting in a derived class, be sure to call the base class's OnCommitting method so that registered delegates receive the event.

The following example demonstrates the OnCommitting method of the Installer class. The OnCommitting method is overridden in the derived class. Space is provided for the user to add the steps to be performed before committing and after committing.

C++

   // Override the 'OnCommitting' method.
protected:
   virtual void OnCommitting( IDictionary^ savedState ) override
   {
      Installer::OnCommitting( savedState );

      // Add steps to be done before committing an application.
      Console::WriteLine( "The OnCommitting method of MyInstaller called" );
   }

Version Information

.NET Framework
Available since 1.1