GridView.PageIndexChanged Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control GridView se ocupe de la operación de paginación.
public:
event EventHandler ^ PageIndexChanged;public event EventHandler PageIndexChanged;member this.PageIndexChanged : EventHandler Public Custom Event PageIndexChanged As EventHandler Tipo de evento
Ejemplos
En el ejemplo siguiente se muestra cómo usar el PageIndexChanged evento para mostrar el número de página seleccionado por el usuario de la fila del buscapersonas.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_DataBound(Object sender, EventArgs e)
{
if (!IsPostBack)
{
// Call a helper method to display the current page number
// when the page is first loaded.
DisplayCurrentPage();
}
}
void CustomersGridView_PageIndexChanged(Object sender, EventArgs e)
{
// Call a helper method to display the current page number
// when the user navigates to a different page.
DisplayCurrentPage();
}
void DisplayCurrentPage()
{
// Calculate the current page number.
int currentPage = CustomersGridView.PageIndex + 1;
// Display the current page number.
Message.Text = "Page " + currentPage.ToString() + " of " +
CustomersGridView.PageCount.ToString() + ".";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView PageIndexChanged Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView PageIndexChanged Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
ondatabound="CustomersGridView_DataBound"
onpageindexchanged="CustomersGridView_PageIndexChanged"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"
pagebuttoncount="10"/>
<pagerstyle backcolor="LightBlue"/>
</asp:gridview>
<!-- 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="CustomersSource"
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">
<script runat="server">
Sub CustomersGridView_DataBound(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Call a helper method to display the current page number
' when the page is first loaded.
DisplayCurrentPage()
End If
End Sub
Sub CustomersGridView_PageIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
' Call a helper method to display the current page number
' when the user navigates to a different page.
DisplayCurrentPage()
End Sub
Sub DisplayCurrentPage()
' Calculate the current page number.
Dim currentPage As Integer = CustomersGridView.PageIndex + 1
' Display the current page number.
Message.Text = "Page " & currentPage.ToString() & " of " & _
CustomersGridView.PageCount.ToString() & "."
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView PageIndexChanged Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView PageIndexChanged Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
ondatabound="CustomersGridView_DataBound"
onpageindexchanged="CustomersGridView_PageIndexChanged"
runat="server">
<pagersettings mode="Numeric"
position="Bottom"
pagebuttoncount="10"/>
<pagerstyle backcolor="LightBlue"/>
</asp:gridview>
<!-- 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="CustomersSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Comentarios
El PageIndexChanged evento se genera cuando se hace clic en uno de los botones de paginación, pero después de que el GridView control controla la operación de paginación. Esto le permite proporcionar un método de control de eventos que realiza una rutina personalizada, como una operación de paginación personalizada, siempre que se produzca este evento.
Para determinar el índice de la página seleccionada por el usuario, use la PageIndex propiedad del GridView control .
Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.
