System.Configuration.Install

Loads an assembly, and runs all the installers in it.

Initializes a new instance of the class.

Initializes a new instance of the class, and specifies both the assembly to install and the command line to use when creating a new object.

The to install. The command line to use when creating a new object for the assembly's installation. Can be a null value.

Initializes a new instance of the class, and specifies both the file name of the assembly to install and the command line to use when creating a new object for the assembly's installation.

The file name of the assembly to install. The command line to use when creating a new object for the assembly's installation. Can be a null value.

Gets or sets the assembly to install.

An that defines the assembly to install. The property value is null.

Checks to see if the specified assembly can be installed.

The assembly in which to search for installers. The specified assembly cannot be installed.

Gets or sets the command line to use when creating a new object for the assembly's installation.

An array of type that represents the command line to use when creating a new object for the assembly's installation.

Completes the installation transaction.

An that contains the state of the computer after all the installers in the installer collection have run. The parameter is null.-or- The saved-state might have been corrupted.-or- A file could not be found. An error occurred in the event handler of one of the installers in the collection.-or- An error occurred in the event handler of one of the installers in the collection.-or- An exception occurred during the phase of the installation. The exception is ignored and the installation continues. However, the application might not function correctly after installation completes.-or- Installer types were not found in one of the assemblies.-or- An instance of one of the installer types could not be created. An exception occurred during the phase of the installation. The exception is ignored and the installation continues. However, the application might not function correctly after installation completes.

Gets the help text for all the installers in the installer collection.

The help text for all the installers in the installer collection, including the description of what each installer does and the command-line options (for the installation program) that can be passed to and understood by each installer.

Performs the installation.

An used to save information needed to perform a commit, rollback, or uninstall operation. The parameter is null.-or- A file could not be found. An exception occurred in the event handler of one of the installers in the collection.-or- An exception occurred in the event handler of one of the installers in the collection.-or- Installer types were not found in one of the assemblies.-or- An instance of one of the installer types could not be created.

Gets or sets the path of the assembly to install.

The path of the assembly to install.

Restores the computer to the state it was in before the installation.

An that contains the pre-installation state of the computer. The parameter is null.-or- The saved-state might have been corrupted.-or- A file could not be found. An exception occurred in the event handler of one of the installers in the collection.-or- An exception occurred in the event handler of one of the installers in the collection.-or- An exception occurred during the phase of the installation. The exception is ignored and the rollback continues. However, the computer might not be fully reverted to its initial state after the rollback completes.-or- Installer types were not found in one of the assemblies.-or- An instance of one of the installer types could not be created. An exception occurred during the phase of the installation. The exception is ignored and the rollback continues. However, the computer might not be fully reverted to its initial state after the rollback completes.

Removes an installation.

An that contains the post-installation state of the computer. The saved-state might have been corrupted.-or- A file could not be found. An error occurred in the event handler of one of the installers in the collection.-or- An error occurred in the event handler of one of the installers in the collection.-or- An exception occurred while uninstalling. The exception is ignored and the uninstall continues. However, the application might not be fully uninstalled after the uninstall completes.-or- Installer types were not found in one of the assemblies.-or- An instance of one of the installer types could not be created.-or- A file could not be deleted. An exception occurred while uninstalling. The exception is ignored and the uninstall continues. However, the application might not be fully uninstalled after the uninstall completes.

Gets or sets a value indicating whether to create a new object for the assembly's installation.

true if a new object should be created for the assembly's installation; otherwise, false. The default is true.

Specifies an installer that copies properties from a component to use at install time.

Initializes a new instance of the class.

When overridden in a derived class, copies all the properties that are required at install time from the specified component.

The component to copy from.

Determines if the specified installer installs the same object as this installer.

true if this installer and the installer specified by the parameter install the same object; otherwise, false. The installer to compare.

Provides an interface for a managed installer.

Executes a managed installation.

The return code for installutil.exe. A successful installation returns 0. Other values indicate failure. The command line that specifies the installation. The handle to the installation.

Contains information about the current installation.

Initializes a new instance of the class.

Initializes a new instance of the class, and creates a log file for the installation.

The path to the log file for this installation, or null if no log file should be created. The command-line parameters entered when running the installation program, or null if none were entered.

Determines whether the specified command-line parameter is true.

true if the specified parameter is set to "yes", "true", "1", or an empty string (""); otherwise, false. The name of the command-line parameter to check.

Writes a message to the console and to the log file for the installation.

The message to write.

Gets the command-line parameters that were entered when InstallUtil.exe was run.

A that represents the command-line parameters that were entered when the installation executable was run.

Parses the command-line parameters into a string dictionary.

A containing the parsed command-line parameters. An array containing the command-line parameters.

Provides the foundation for custom installations.

Initializes a new instance of the class.

Occurs after the methods of all the installers in the property have run.

Occurs after the installations of all the installers in the property are rolled back.

Occurs after all the installers in the property perform their uninstallation operations.

Occurs before the method of each installer in the installer collection has run.

Occurs before the installers in the property are rolled back.

Occurs before the installers in the property perform their uninstall operations.

When overridden in a derived class, completes the install transaction.

An that contains the state of the computer after all the installers in the collection have run. The parameter is null.-or- The saved-state might have been corrupted. An exception occurred during the phase of the installation. This exception is ignored and the installation continues. However, the application might not function correctly after the installation is complete.

Occurs after all the installers in the property have committed their installations.

Occurs before the installers in the property committ their installations.

Gets or sets information about the current installation.

An that contains information about the current installation.

Gets the help text for all the installers in the installer collection.

The help text for all the installers in the installer collection, including the description of what the installer does and the command line options for the installation executable, such as the InstallUtil.exe utility, that can be passed to and understood by this installer. One of the installers in the installer collection specifies a null reference instead of help text. A likely cause for this exception is that a field to contain the help text is defined but not initialized.

When overridden in a derived class, performs the installation.

An used to save information needed to perform a commit, rollback, or uninstall operation. The parameter is null. An exception occurred in the event handler of one of the installers in the collection.-or- An exception occurred in the event handler of one of the installers in the collection.

Gets the collection of installers that this installer contains.

An containing the collection of installers associated with this installer.

Raises the event.

An that contains the state of the computer after all the installers contained in the property have completed their installations.

Raises the event.

An that contains the state of the computer after the installers contained in the property are rolled back.

Raises the event.

An that contains the state of the computer after all the installers contained in the property are uninstalled.

Raises the event.

An that contains the state of the computer before the installers in the property are installed. This object should be empty at this point.

Raises the event.

An that contains the state of the computer before the installers in the property are rolled back.

Raises the event.

An that contains the state of the computer before the installers in the property uninstall their installations.

Raises the event.

An that contains the state of the computer after all the installers in the property run.

Raises the event.

An that contains the state of the computer before the installers in the property are committed.

Gets or sets the installer containing the collection that this installer belongs to.

An containing the collection that this instance belongs to, or null if this instance does not belong to a collection.

When overridden in a derived class, restores the pre-installation state of the computer.

An that contains the pre-installation state of the computer. The parameter is null.-or- The saved-state might have been corrupted. An exception occurred during the phase of the installation. This exception is ignored and the rollback continues. However, the computer might not be fully reverted to its initial state after the rollback completes.

When overridden in a derived class, removes an installation.

An that contains the state of the computer after the installation was complete. The saved-state might have been corrupted. An exception occurred while uninstalling. This exception is ignored and the uninstall continues. However, the application might not be fully uninstalled after the uninstallation completes.

Contains a collection of installers to be run during an installation.

Adds the specified installer to this collection of installers.

The zero-based index of the added installer. An that represents the installer to add to the collection.

Adds the specified array of installers to this collection.

An array of type that represents the installers to add to this collection.

Adds the specified collection of installers to this collection.

An that represents the installers to add to this collection.

Determines whether the specified installer is included in collection.

true if the specified installer is in this collection; otherwise, false. An that represents the installer to look for.

Copies the items from the collection to an array, begining at the specified index.

The array to copy to. The index of the array at which to paste the collection.

Determines the index of a specified installer in the collection.

The zero-based index of the installer in the collection. The to locate in the collection.

Inserts the specified installer into the collection at the specified index.

The zero-based index at which to insert the installer. The to insert.

Gets or sets an installer at the specified index.

An that represents the installer at the specified index. The zero-based index of the installer to get or set.

Performs additional custom processes before a new installer is inserted into the collection.

The zero-based index at which to insert . The new value of the installer at .

Performs additional custom processes before an installer is removed from the collection.

The zero-based index at which can be found. The installer to be removed from .

Performs additional custom processes before an existing installer is set to a new value.

The zero-based index at which to replace . The value to replace with The new value of the installer at .

Removes the specified from the collection.

An that represents the installer to remove.

Provides data for the events: , , , , , , , .

Initializes a new instance of the class, and leaves the property empty.

Initializes a new instance of the class, and specifies the value for the property.

An that represents the current state of the installation.

Gets an that represents the current state of the installation.

An that represents the current state of the installation.

Represents the method that will handle the , , , , , , , or event of an .

The source of the event. An that contains the event data.

The exception that is thrown when an error occurs during the commit, rollback, or uninstall phase of an installation.

Initializes a new instance of the class.

Initializes a new instance of the class with serialized data.

The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination.

Initializes a new instance of the class, and specifies the message to display to the user.

The message to display to the user.

Initializes a new instance of the class, and specifies the message to display to the user, and a reference to the inner exception that is the cause of this exception.

The message to display to the user. The exception that is the cause of the current exception. If the parameter is not null, the current exception is raised in a catch block that handles the inner exception.

Represents a managed install.

Initializes a new instance of the class.

Handles the functionality of the Installer Tool (Installutil.exe).

The arguments passed to the Installer Tool.

For a description of this member, see .

The return code for installutil.exe. A successful installation returns 0. Other values indicate failure. The command line to install. The handle to the installation.

Defines an installer that either succeeds completely or fails and leaves the computer in its initial state.

Initializes a new instance of the class.

Performs the installation.

An in which this method saves information needed to perform a commit, rollback, or uninstall operation. The parameter is null. The installation failed, and is being rolled back.

Removes an installation.

An that contains the state of the computer after the installation completed.

Specifies what an installer should do during an uninstallation.

Removes the resource the installer created.

Leaves the resource created by the installer as is.

Allows you to install and configure an event log that your application reads from or writes to when running.

Initializes a new instance of the class.

Gets or sets the number of categories in the category resource file.

The number of categories in the category resource file. The default value is zero.

Gets or sets the path of the resource file that contains category strings for the source.

The path of the category resource file. The default is an empty string ("").

Copies the property values of an component that are required at installation time for an event log.

An to use as a template for the . The specified component is not an .-or- The or property of the specified component is either null or empty.

Performs the installation and writes event log information to the registry.

An used to save information needed to perform a rollback or uninstall operation. The platform the installer is trying to use is not Windows NT 4.0 or later. The name specified in the property is already registered for a different event log.

Determines whether an installer and another specified installer refer to the same source.

true if this installer and the installer specified by the parameter would install or uninstall the same source; otherwise, false. The installer to compare.

Gets or sets the name of the log to set the source to.

The name of the log. This can be Application, System, or a custom log name. The default is an empty string ("").

Gets or sets the path of the resource file that contains message formatting strings for the source.

The path of the message resource file. The default is an empty string ("").

Gets or sets the path of the resource file that contains message parameter strings for the source.

The path of the message parameter resource file. The default is an empty string ("").

Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.

An that contains the pre-installation state of the computer.

Gets or sets the source name to register with the log.

The name to register with the event log as a source of entries. The default is an empty string ("").

Removes an installation by removing event log information from the registry.

An that contains the pre-installation state of the computer.

Gets or sets a value that indicates whether the Installer Tool (Installutil.exe) should remove the event log or leave it in its installed state at uninstall time.

One of the values that indicates what state to leave the event log in when the is uninstalled. The default is Remove. contains an invalid value. The only valid values for this property are Remove and NoAction.

Specifies an installer for the component.

Initializes a new instance of the class.

Gets or sets the descriptive message for the performance counter.

The descriptive message for the performance counter. The value is set to null.

Gets or sets the performance category name for the performance counter.

The performance category name for the performance counter. The value is set to null. The value is not a valid category name.

Gets or sets the performance counter category type.

One of the values. The value is not a .

Copies all the properties from the specified component that are required at install time for a performance counter.

The component to copy from. The specified component is not a .-or- The specified is incomplete.-or- Multiple counters in different categories are trying to be installed.

Gets a collection of data that pertains to the counters to install.

A that contains the names, help messages, and types of the counters to install.

Performs the installation.

An that is used to save the information needed to perform a commit, rollback, or uninstall operation.

Restores the computer to the state it was in before the installation.

An that contains the pre-installation state of the computer.

Removes an installation.

An that contains the post-installation state of the computer.

Gets a value that indicates whether the performance counter should be removed at uninstall time.

One of the values. The default is Remove. The value is not an .