NextPreviousPagerField.ButtonType Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property System::Web::UI::WebControls::ButtonType ButtonType { System::Web::UI::WebControls::ButtonType get(); void set(System::Web::UI::WebControls::ButtonType value); };

public System.Web.UI.WebControls.ButtonType ButtonType { get; set; }

member this.ButtonType : System.Web.UI.WebControls.ButtonType with get, set

Public Property ButtonType As ButtonType

Property Value

ButtonType

One of the ButtonType values. The default is ButtonType.Link.

Exceptions

ArgumentOutOfRangeException

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

Examples

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>

<%@ Page language="VB" %>
    
<!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>

Remarks

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.

Applies to

Jaa