New to Telerik UI for ASP.NET AJAXStart a free 30-day trial

Telerik.Web.UI.RadDataPager

RadDataPager can be used to display paging navigation controls for other data-bound controls that implement the IPageableItemContainer or IRadPageableItemContainer interface (like the RadListView and MS ListView). The RadDataPager control lets users view large sets of data in small chunks for faster loading and easier navigation. It also provides a set of events, helper methods and properties for custom intervention.

Inheritance Hierarchy

  • System.Object
  • System.Web.UI.Control
  • System.Web.UI.WebControls.WebControl
  • Telerik.Web.UI.RadWebControl : IControl, IControlResolver, IPostBackDataHandler, IScriptControl, ISkinnableControl
  • Telerik.Web.UI.RadDataPager : ICompositeControlDesignerAccessor, INamingContainer, IPostBackEventHandler

Properties

AllowRouting Boolean

Gets or sets if the routing is enabled.

AllowSEOPaging Boolean

Get or set whether SEO paging should be used.

ClientEvents RadDataPagerClientEvents

Gets a reference to , which holds properties for setting the client-side events

ClientIDMode ClientIDMode

This property is overridden in order to support controls which implement INamingContainer. The default value is changed to "AutoID".

ContainerLocator PageableItemContainerLocator

Gets reference to which helps in search for controls by ID, Type or finding the controls implementing .

Controls ControlCollection

Gets a object that represents the child controls for a specified server control in the UI hierarchy.

CssClassFormatString String

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

Culture CultureInfo

Gets or sets the selected culture. Localization strings will be loaded based on this value.

CurrentPageIndex Int32

Gets the index of the current page.

EnableAjaxSkinRendering String

Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests

Remarks

If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax.

EnableAriaSupport Boolean

When set to true enables support for WAI-ARIA

EnableEmbeddedBaseStylesheet Boolean

Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.

Remarks

If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand.

EnableEmbeddedScripts Boolean

Gets or sets the value, indicating whether to render script references to the embedded scripts or not.

Remarks

If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand.

EnableEmbeddedSkins String

Gets or sets the value, indicating whether to render links to the embedded skins or not.

Remarks

If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand.

EnableRippleEffect Boolean

Returns true if ripple effect should be added

Fields RadDataPagerFieldCollection

Gets a collection of items.

IsSkinSet String

For internal use.

LocalizationPath DataPagerStrings

Gets or sets a value indicating where RadDataPager will look for its .resx localization file. By default this file should be in the App_GlobalResources folder. However, if you cannot put the resource file in the default location or .resx files compilation is disabled for some reason (e.g. in a DotNetNuke environment), this property should be set to the location of the resource file.

Remarks

If specified, the LocalizationPath property will allow you to load the grid localization file from any location in the web application.

MaximumRows Int32

Gets the maximum rows.

OriginalPageSize Int32

It is used for storing page size set declaratively In order to show this page size in the combo box with page sizes

PageableItemContainer IRadPageableItemContainer

Read only property. Holds reference to control that implements IRadPageableItemContainer or IPageableItemContainer.

PageCount Int32

Gets the page count of the target paged control.

PagedControlID String

Gets or sets the ID of the control which will be paged.

PageSize Int32

Gets or sets the page size of the target paged control.

RegisterWithScriptManager Boolean

Gets or sets the value, indicating whether to register with the ScriptManager control on the page.

Remarks

If RegisterWithScriptManager is set to false the control can be rendered on the page using Web Services or normal callback requests/page methods.

RemoveUrlFromDisabledHyperLinkButtons Boolean

When SEO paging is enabled this property will remove the URL from the HyperLink buttons and will replace it with sharp sign (#). No 'return false' will be used in this case.

RenderMode RenderMode

Specifies the rendering mode of the control. Setting the mode to Lightweight will yield HTML 5/CSS 3 html and css.

Remarks

Lightweight rendering mode might change the outlook of the component in some older browsers that don't support CSS3/HTML5.

ResolvedRenderMode RenderMode

Returns resolved RenderMode should the original value was Auto

RouteName String

Gets or sets the name of the route.

RoutePageIndexParameterName String

Gets or sets the name of the route page index parameter.

RuntimeSkin String

Gets the real skin name for the control user interface. If Skin is not set, returns "Default", otherwise returns Skin.

SEOPagingQueryPageKey String

Get or set query string key for SEO paging. This property may be used in conjunction with AllowSEOPaging

Skin String

Gets or sets the skin name for the control user interface.

Remarks

If this property is not set, the control will render using the skin named "Default". If EnableEmbeddedSkins is set to false, the control will not render skin.

StartRowIndex Int32

Gets the start row index in the specified data source.

TotalRowCount Int32

Gets the total row count which represents the count in the specified data source.

Methods

AddListenersToContainer

Add listener to IRadPageableItemContainer events.

Returns

System.Void

ApplyConditionalRendering

Use this from RenderContents of the inheritor

Returns

System.Void

CallCommand

Raises event

Parameters

e Telerik.Web.UI.RadDataPagerCommandEventArgs

Returns

System.Void

CallCommandToContainer

This method is called whenever any command bubbles from RadDataPagerField. If the command can be handled from RadDataPager it will return true and event bubbling will be prevented. If command name is custom return value will be false and command will continue to bubble.

Parameters

commandName System.String

Could be any of the predefined RadDataPager commands or any custom command.

commandArgument System.String

Could be any of the predefined RadDataPager commands arguments or any custom argument.

Returns

System.Boolean Return false will command should continue bubble or true if command is handled by RadDataPager.

ControlPreRender

Code moved into this method from OnPreRender to make sure it executed when the framework skips OnPreRender() for some reason

Returns

System.Void

CreateDataPagerFields

This method is called to create all RadDataPager fields.

Returns

System.Void

FireCommand

Triggers command on RadDataPager.

Parameters

commandName System.String

Command that will be fired.

commandArgument System.String

Arguments of the command.

Returns

System.Void

FireCommand

Triggers command on RadDataPager.

Parameters

commandArgs Telerik.Web.UI.RadDataPagerCommandEventArgs

Command argument to be processed by RadDataPager

Returns

System.Void

GetEmbeddedSkinNames

Returns the names of all embedded skins. Used by Telerik.Web.Examples.

Returns

System.Collections.Generic.List1`

HandleSEOPaging

This method checks query string for the key specified by SEOPagingQueryPageKey and if present attempt to page.

Returns

System.Void

LoadClientState

Loads the client state data

Parameters

clientState System.Collections.Generic.Dictionary{System.String,System.Object}

Returns

System.Void

LoadPostData

Executed when post data is loaded from the request

Parameters

postDataKey System.String

postCollection System.Collections.Specialized.NameValueCollection

Returns

System.Boolean

OnBubbleEvent

Handles event that bubbles from any RadDataPagerField. Command event will be triggered.

Parameters

source System.Object

args System.EventArgs

Returns

System.Boolean

OnPageIndexChanged

Raises event

Parameters

e Telerik.Web.UI.RadDataPagerPageIndexChangeEventArgs

Returns

System.Void

OnTotalRowCountAvailable

This method is called when total row count is supplied by IRadPageableContainer.

Parameters

sender System.Object

IRadPageableContainer itself

e Telerik.Web.UI.RadDataPagerPageEventArgs

DataPagerPageEventArgs arguments for creating pager fields

Returns

System.Void

OnTotalRowCountRequest

Raises event

Parameters

e Telerik.Web.UI.RadDataPagerTotalRowCountRequestEventArgs

Returns

System.Void

RaisePostDataChangedEvent

Executed when post data changes should invoke a changed event

Returns

System.Void

RegisterCssReferences

Registers the CSS references

Returns

System.Void

RegisterScriptControl

Registers the control with the ScriptManager

Returns

System.Void

SaveClientState

Saves the client state data

Returns

System.String