This documentation is archived and is not being maintained.

NextPreviousPagerField.ButtonType Property

Gets or sets the button type to display in the pager field.

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

public ButtonType ButtonType { get; set; }

Property Value

Type: System.Web.UI.WebControls.ButtonType
One of the ButtonType values. The default is ButtonType.Link.

ExceptionCondition
ArgumentOutOfRangeException

The value for the ButtonType property is not one of the ButtonType values.

Use the ButtonType property to specify which type of button is displayed in a button field. The following table lists the available button types.

Button type value

Description

Button

A Button control.

Image

An ImageButton control.

Link

A LinkButton control.

When ButtonType is set to ButtonType.Image, you must set the image to display for the buttons by using the properties shown in the following table.

Property

Description

FirstPageImageUrl

The URL to an image to display for the first-page button.

PreviousPageImageUrl

The URL to an image to display for the previous-page button.

NextPageImageUrl

The URL to an image to display for the next-page button.

LastPageImageUrl

The URL to an image to display for the last-page button.

The value of the ButtonType property is stored in viewstate.

The following example shows how to use the ButtonType property to specify that image buttons are displayed in the NextPreviousPagerField object of a DataPager control.

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>NextPreviousPagerField Example</title>
    <style type="text/css">
      .header
      {
      	background-color:Gray;
      	color:White;
      }
    </style>
</head>
<body>
    <form id="form1" runat="server">

      <h3>NextPreviousPagerField Example</h3>

      <asp:ListView ID="VendorsListView" 
        DataSourceID="VendorsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblVendor">
            <tr align="center" class="header" runat="server">
              <th runat="server">ID</th>
              <th runat="server">Vendor Name</th>
              <th runat="server">Active</th>
            </tr>
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%#Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td align="center">
              <asp:CheckBox ID="ActiveFlagCheck" runat="server" 
                Checked='<%#Eval("ActiveFlag") %>' 
                Enabled="false" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" 
        PagedControlID="VendorsListView" 
        PageSize="15">
        <Fields>
          <asp:NextPreviousPagerField 
            ShowFirstPageButton="true" 
            ShowLastPageButton="true"
            FirstPageImageUrl="~/images/first.gif" 
            LastPageImageUrl="~/images/last.gif"
            NextPageImageUrl="~/images/next.gif" 
            PreviousPageImageUrl="~/images/previous.gif"
            ButtonType="Image" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="VendorsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [VendorID], [Name], [ActiveFlag] FROM Purchasing.Vendor">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5
Show: