Back to Devexpress

ASPxDockPanel.LoadContentViaCallback Property

aspnet-devexpress-dot-web-dot-aspxdockpanel.md

latest4.3 KB
Original Source

ASPxDockPanel.LoadContentViaCallback Property

Gets or sets a value specifying the content loading mode for the ASPxDockPanel.

Namespace : DevExpress.Web

Assembly : DevExpress.Web.v25.2.dll

NuGet Package : DevExpress.Web

Declaration

csharp
[DefaultValue(LoadPanelContentViaCallback.None)]
public LoadPanelContentViaCallback LoadContentViaCallback { get; set; }
vb
<DefaultValue(LoadPanelContentViaCallback.None)>
Public Property LoadContentViaCallback As LoadPanelContentViaCallback

Property Value

TypeDefaultDescription
LoadPanelContentViaCallbackNone

One of the LoadPanelContentViaCallback enumeration values.

|

Available values:

NameDescription
None

Specifies that the content is always (initially) rendered inside panels.

| | OnFirstShow |

Specifies that loading panel contents occurs when a panel is invoked for the first time.

| | OnPageLoad |

Specifies that loading panel contents occurs immediately after the entire page has been loaded.

| | OnDock |

Specifies that loading panel contents occurs after a panel is docked or it changes a position within a zone via end-user interaction. If the panel is initially docked, the panel content is loaded on the Page_Load.

| | OnFloating |

Specifies that loading panel contents occurs after a panel leaves a zone (undocks) or after it is moved (in the floating state) via an end-user interaction.

| | OnDockStateChange |

Specifies that loading panel contents occurs after a panel changes its state, changes its position within a zone, or is moved (in the floating state) via an end-user interaction.

|

Remarks

Use the LoadContentViaCallback property to control when a panel’s contents should be loaded.

Using the postponed load of panel contents (by setting the LoadContentViaCallback property to LoadPanelContentViaCallback.OnPageLoad or LoadPanelContentViaCallback.OnFloating), you can enhance the response time of your web page on its initial load.

You can load panel contents every time the panel is docked (LoadPanelContentViaCallback.OnDock), undocked (LoadPanelContentViaCallback.OnFloating), or on every dock state change (LoadPanelContentViaCallback.OnDockStateChange).

Note that you can also update the content of panels programmatically, on demand (by using the client ASPxClientPopupControlBase.PerformCallback method). On-demand panel loading is realized by sending a callback to the server for the panel’s content. During a callback, a specific loading panel can be displayed within the panel.

Note

The LoadContentViaCallback property does not influence the ASPxDockPanel loading content process if the content is specified via the ASPxPopupControlBase.ContentUrl property.

See Also

PerformCallback(parameter)

SettingsLoadingPanel

Panel Overview

Docking

Online Demo: Docking - Callbacks (AJAX)

ASPxDockPanel Class

ASPxDockPanel Members

DevExpress.Web Namespace