Export (0) Print
Expand All

UpdatePanel.UpdateMode Property

Gets or sets a value that indicates when an UpdatePanel control's content is updated.

Namespace:  System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

member UpdateMode : UpdatePanelUpdateMode with get, set

Property Value

Type: System.Web.UI.UpdatePanelUpdateMode
One of the UpdatePanelUpdateMode values. The default is Always.

ExceptionCondition
ArgumentOutOfRangeException

The specified type is not one of the UpdatePanelUpdateMode values.

When an UpdatePanel control is not inside another UpdatePanel control, the panel is updated according to the settings of the UpdateMode and ChildrenAsTriggers properties, together with the collection of triggers. When an UpdatePanel control is inside another UpdatePanel control, the child panel is automatically updated when the parent panel is updated.

The content of an UpdatePanel control is updated in the following circumstances:

  • If the UpdateMode property is set to Always, the UpdatePanel control's content is updated on every postback that originates from anywhere on the page. This includes asynchronous postbacks from controls that are inside other UpdatePanel controls and postbacks from controls that are not inside UpdatePanel controls.

  • If the UpdatePanel control is nested inside another UpdatePanel control and the parent update panel is updated.

  • If the UpdateMode property is set to Conditional, and one of the following conditions occurs:

    • You call the Update method of the UpdatePanel control explicitly.

    • The postback is caused by a control that is defined as a trigger by using the Triggers property of the UpdatePanel control. In this scenario, the control explicitly triggers an update of the panel content. The control can be either inside or outside the UpdatePanel control that defines the trigger.

    • The ChildrenAsTriggers property is set to true and a child control of the UpdatePanel control causes a postback. A child control of a nested UpdatePanel control does not cause an update to the outer UpdatePanel control unless it is explicitly defined as a trigger.

The following example shows how to use the UpdateMode property. The example declares two UpdatePanel controls. In the first panel, the UpdateMode property is set to Conditional. In the second panel, UpdateMode is set to Always. A button outside both panels is registered as an asynchronous postback control by calling the RegisterAsyncPostBackControl method of the ScriptManager control. In the button's Click event handler, the Update method of the first panel is called if more than five seconds have elapsed since its last update. In this scenario, the panel’s content is updated only if the last panel refresh was more than five seconds ago. The content of the second panel is always updated.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5
Show:
© 2015 Microsoft