Tab

ASPxDockPanel.LoadContentViaCallback Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

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

Property Value

Type Default Description
LoadPanelContentViaCallback

None

One of the LoadPanelContentViaCallback enumeration values.

Available values:

Name Description
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