System.Web.UI.WebControls Namespace   GridView Class

---

.NET Framework version 2.0

Defines or retrieves the settings for the pager element in a GridView control.

Script	GridView.PagerSettings.Property [ = enumValue ]

A PagerSettings object that defines the settings for the pager element in a GridView.

Use the PagerSettings property to control the behavior 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.

The PagerSettings subproperties can be set declaratively using either of the following methods:

• Include an attribute in the opening tag of the GridView control in the form PagerSettings-Property

  <asp:gridview ... 
     pagersettings-property=value
     ... >
  
  </asp:gridview>

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

  <asp:gridview ... >
  
     <pagersettings
        ... property definitions here />
  
  </asp:gridview>

The subproperties can also be set programmatically in the form PagerSettings.Property. Common settings usually include the pager row's display mode and custom text or images for the navigation controls.

For a list of pager properties that can be set, see the PagerSettings class.

The following example shows how to initally set the PagerSettings property of a GridView control at design time, which can be changed dynamically at run time.

<asp:gridview id = "plansGrid" runat = "server"
   ... >

   <pagersettings
      mode = "nextprevious"
      nextpagetext = "Next" previouspagetext = "Back" 
      position = "top"
      pagebuttoncount=10 />

   <columns>
      ...
   </columns>

</asp:gridview>

GridView with Default Paging Run Sample | View Source

GridView Members   PagerStyle

Suggested Reading