WebUpdateController Methods

The methods of the WebUpdateController class are listed here. For a complete list of WebUpdateController class members, see the WebUpdateController Members topic.

Public Methods

BeginApplyUpdate

This method starts an ApplyUpdate() operation.

BeginCheckForUpdate

This method starts a CheckForUpdate() operation. The method returns immediately and the proxy updater performs the operation asynchronously. BeginCheckForUpdate() returns an object that can be passed to GetOperationStatus() to retrieve information about the CheckForUpdate() operation. This identity will also be assigned to the UpdateInformation that represents the found update, if one is found. Since multiple WebUpdateControllers can call BeginCheckForUpdate(), each using different properties (such as UpdateLocation), this identity can be used to verify that the UpdateInformation you choose to download is the correct one. Only one asynchronous operation can be in progress at once; until the BeginCheckForUpdate() operation is finished (either CompleteOrUnknown or Failed), BeginCheckForUpdate(), BeginDownloadUpdate(), and BeginApplyUpdate() cannot be called. Use CancelOperation(), passing the identity returned by BeginCheckForUpdate(), to cancel the check.

BeginDownloadUpdate

This method starts a DownloadUpdate() operation. The method returns immediately and the update controller performs the operation asynchronously.

CancelOperation

This method cancels the operation specified by operationIdentity, if that operation is currently in progress (Working). BeginCheckForUpdate() and BeginDownloadUpdate() start operations that can be cancelled.

GetCurrentUpdate

This method immediately returns an UpdateInformation instance containing information about the update found by the proxy updater. If the proxy updater has not found an update, GetCurrentUpdate() returns null. UpdateInformation contains the same information as Kjs.AppLife.Controller.UpdateInformation, with an additional property that contains the identity for the CheckForUpdate operation that was used to retrieve the UpdateInformation.

GetOperationStatus

This method is used to immediately retrieve information about a known long-running operation on the proxy updater. It can be used for information about the current operation or a previously completed operation; however, information about previously completed operations is periodically discarded by the proxy updater.

GetStatus

This method immediately returns a ControllerStatus instance that contains information about the controller.

Protected Methods

LoadControlState

Overridden. Restores control-state information from a previous page request that was saved by the SaveControlState method.

OnInit

Overridden. Raises the Init event.

SaveControlState

Overridden. Saves any server control state changes that have occurred since the time the page was posted back to the server.

See Also

WebUpdateController Class | Kjs.AppLife.Update.Web Namespace