GridView::PagerSettings Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a reference to the PagerSettings object that enables you to set the properties of the pager buttons in a GridView control.

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

public:
[PersistenceModeAttribute(PersistenceMode::InnerProperty)]
property PagerSettings^ PagerSettings {
	virtual PagerSettings^ get();
}

Property Value

Type: System.Web.UI.WebControls::PagerSettings^

A reference to the PagerSettings that enables you to set the properties of the pager buttons in a GridView control.

Use the PagerSettings property to control the settings of the pager row in a GridView control. The pager row is displayed when the paging feature is enabled (by setting the AllowPaging property to true) and contains the controls that allow the user to navigate to the different pages in the control. This property is read-only; however, you can set the properties of the PagerSettings object it returns. The properties can be set declaratively using one of the following methods:

  • Place an attribute in the opening tag of the GridView control in the form Property-Subproperty, where Subproperty is a property of the PagerSettings object (for example, PagerSettings-Mode).

  • Nest a <PagerSettings> element between the opening and closing tags of the GridView control.

The properties can also be set programmatically in the form Property.Subproperty (for example, PagerStyle.Mode). Common settings usually include the pager row's display mode and custom text or images for the navigation controls.

The following example demonstrates how to set the PagerSettings property declaratively. It sets the font and background for the pager row to blue and light blue, respectively.

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

.NET Framework
Available since 2.0
Return to top
Show: