PagerSettings.NextPageImageUrl Property
Definition
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 URL to an image to display for the next-page button.
public:
property System::String ^ NextPageImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string NextPageImageUrl { get; set; }
member this.NextPageImageUrl : string with get, set
Public Property NextPageImageUrl As String
Property Value
The URL to an image to display for the next-page button. The default is an empty string (""), which indicates that the NextPageImageUrl is not set.
Examples
The following code example demonstrates how to use the NextPageImageUrl property to display an image for the next-page button in the pager row of a GridView 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 runat="server">
<title>PagerSetting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>PagerSetting Example</h3>
<asp:gridview id="CustomerGridView"
datasourceid="CustomerDataSource"
autogeneratecolumns="true"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<pagersettings mode="NextPreviousFirstLast"
firstpageimageurl="~/Images/FirstPage.jpg"
firstpagetext="First Page"
lastpageimageurl="~/Images/LastPage.jpg"
lastpagetext="Last Page"
nextpageimageurl="~/Images/NextPage.jpg"
nextpagetext="Next Page"
previouspageimageurl="~/Images/PreviousPage.jpg"
previouspagetext="Previous Page"
position="Bottom"/>
</asp:gridview>
<br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomerDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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 runat="server">
<title>PagerSetting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>PagerSetting Example</h3>
<asp:gridview id="CustomerGridView"
datasourceid="CustomerDataSource"
autogeneratecolumns="true"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<pagersettings mode="NextPreviousFirstLast"
firstpageimageurl="~/Images/FirstPage.jpg"
firstpagetext="First Page"
lastpageimageurl="~/Images/LastPage.jpg"
lastpagetext="Last Page"
nextpageimageurl="~/Images/NextPage.jpg"
nextpagetext="Next Page"
previouspageimageurl="~/Images/PreviousPage.jpg"
previouspagetext="Previous Page"
position="Bottom"/>
</asp:gridview>
<br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomerDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Remarks
When the Mode property is set to the NumericFirstLast or NextPrevious value, use the NextPageImageUrl property to specify the URL to an image to display for the next-page button.
Note
As an alternative, you can simply display text for the next-page button by setting the NextPageText property instead of the NextPageImageUrl property. If the NextPageImageUrl and NextPageText properties are both set, the image is displayed with the NextPageText property acting as the alternate text for the image. On browsers that support ToolTips, this text is also displayed as a ToolTip for the corresponding button.
The value of this property is stored in view state.