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.

Exception Condition
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>

.NET Framework
Available since 3.5
Return to top
Show: