UpdatePanelUpdateMode Enumeration
TOC
Collapse the table of content
Expand the table of content

UpdatePanelUpdateMode Enumeration

.NET Framework (current version)
 

Represents the possible update modes for the content in an UpdatePanel control.

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

type UpdatePanelUpdateMode

Member nameDescription
Always

The content of the UpdatePanel control is updated for all postbacks that originate from the page. This includes asynchronous postbacks.

Conditional

The content of the UpdatePanel control is updated under the following conditions:

The UpdatePanelUpdateMode enumeration defines the possible update modes for the content of an UpdatePanel control. The UpdateMode property must be set to one of the values of the UpdatePanelUpdateMode enumeration. The UpdatePanel control requires that the EnablePartialRendering property of the ScriptManager control be true for partial-page rendering to occur.

The default value of the UpdateMode property is Always.

If the UpdatePanel control is inside another UpdatePanel control and the parent panel is updated, the nested panel will also be updated regardless of the UpdateMode property value.

The following example declares two UpdatePanel controls. The first panel sets the UpdateMode property of an UpdatePanel control to Conditional. The second panel has UpdateMode set to Always by default. A button outside both panels is registered as an asynchronous postback control by using 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 update was more than five seconds ago. The second panel's content is always updated.

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

.NET Framework
Available since 3.5
Return to top
Show:
© 2016 Microsoft