NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Installer Class

Provides a basic framework for doing installations.

Object
   Component
      Installer

[Visual Basic]
Public Class Installer
   Inherits Component
[C#]
public class Installer : Component
[C++]
public __gc class Installer : public Component
[JScript]
public class Installer extends Component

Remarks

This class provides a basic framework for doing an installation. It is the base class for all custom installers in Visual Studio. Installer contains a collection of installers, named Installers, and has methods and properties to run the installers in the collection.

When you call Install, Commit, Rollback, or Uninstall, on this instance, the corresponding method in each of the contained Installer objects is invoked.

If this Installer instance is part of an installer collection, Parent is the Installer instance that contains the collection. See AssemblyInstaller for an example of the use of the Installers collection.

Context contains information about the installation, including the command line that was entered when the installation executable was run. This property contains information about the location of the log file for the installation, the location of the file to save information required by the Uninstall method, and other information needed by the specific installation being run.

The Install, Commit, Rollback, and Uninstall methods will never be called on the same instance. A new instance is created for each of these operations. Each method is passed an IDictionary, that will be preserved across calls, to share information between methods. Generally, the information you put in this state saver dictionary is what you need later to perform a rollback, commit, or uninstall operation.

The following are examples of situations where you might want to save information in the state saver IDictionary:

Requirements

Namespace: System.Configuration.Install

Assembly: System.Configuration.Install.dll

See Also

Installer Members | System.Configuration.Install Namespace | InstallerCollection | ComponentInstaller | AssemblyInstaller | TransactedInstaller