Click or drag to resize
UpdateControllerUpdateInteractive Method (IWin32Window, ErrorDisplayLevel, ApplyUpdateOptions)
Uses built-in dialogs to walk the user through an entire update process, showing the specified amount of information about any error that occurs. The dialogs will be shown in front of the specified object.

Namespace: Kjs.AppLife.Update.Controller
Assembly: Kjs.AppLife.Update.Controller (in Kjs.AppLife.Update.Controller.dll) Version: 5.1.0.9 (5.1.0.9)
Syntax
Copy
public void UpdateInteractive(
	IWin32Window dialogOwner,
	ErrorDisplayLevel errorDisplayLevel,
	ApplyUpdateOptions options
)

Parameters

dialogOwner
Type: System.Windows.FormsIWin32Window
An implementation of IWin32Window that will own the modal dialog.
errorDisplayLevel
Type: Kjs.AppLife.Update.ControllerErrorDisplayLevel
One of the ErrorDisplayLevel values indicating how much error detail can be shown to the user.
options
Type: Kjs.AppLife.Update.ControllerApplyUpdateOptions
A combination of ApplyUpdateOptions values that specifies the behavior of the update process.
Exceptions
ExceptionCondition
InvalidEnumArgumentException

errorDisplayLevel is not a valid ErrorDisplayLevel value.

-or-

options represents a combination of flags not defined in the ApplyUpdateOptions enumeration.

ArgumentExceptionoptions contains both the NoUpdateWindow and AutoClose values.
InvalidOperationExceptionIsBusy is .
ObjectDisposedException

The UpdateController has been disposed.

Remarks

This method combines the functionality of ShowCheckForUpdateDialog and ShowDownloadUpdateDialog and adds a step to automatically attempt to apply the update and display any error that occurs when doing so to the user.

This method displays a "Check for updates" dialog. If an update is found and the user chooses to get it, this method will automatically download it and display a progress dialog. If the download succeeds and is not cancelled by the user, this method will apply the update. If the update is successfully applied, the application will shut down.

If an exception is thrown during any of these steps, a simple message will be shown to the user. If errorDisplayLevel is ShowExceptionMessage, the user can click a button to view the message of the exception and any inner exceptions by clicking a "Show details" button.

See Also