Exportar (0) Imprimir
Expandir todo

GridView.PageIndexChanging (Evento)

Actualización: noviembre 2007

Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control GridView se ocupe de la operación de paginación.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public event GridViewPageEventHandler PageIndexChanging
/** @event */
public void add_PageIndexChanging (GridViewPageEventHandler value)
/** @event */
public void remove_PageIndexChanging (GridViewPageEventHandler value)

JScript no admite eventos.
<asp:GridView OnPageIndexChanging="GridViewPageEventHandler" />

El evento PageIndexChanging se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control GridView se ocupe de la operación de paginación. Esto permite proporcionar un método de control de eventos que realice una rutina personalizada, como cancelar la operación de paginación, siempre que se provoque este evento.

1z6zx7y9.alert_note(es-es,VS.90).gifNota:

Este evento no se produce cuando se establece mediante programación la propiedad PageIndex.

Se pasa un objeto GridViewPageEventArgs al método de control de eventos, lo que permite determinar el índice de página seleccionado por el usuario e indicar que la operación de paginación debe cancelarse. Para cancelar la operación de paginación, establezca la propiedad Cancel del objeto GridViewPageEventArgs en true.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

En el ejemplo siguiente se muestra cómo utilizar el evento PageIndexChanging para cancelar la operación de paginación si el usuario intenta navegar a otra página cuando un control GridView está en modo de edición.


<%@ 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_PageIndexChanging(Object sender, GridViewPageEventArgs e)
  {

    // Cancel the paging operation if the user attempts to navigate
    // to another page while the GridView control is in edit mode. 
    if (CustomersGridView.EditIndex != -1)
    {
      // Use the Cancel property to cancel the paging operation.
      e.Cancel = true;

      // Display an error message.
      int newPageNumber = e.NewPageIndex + 1;
      Message.Text = "Please update the record before moving to page " +
        newPageNumber.ToString() + ".";
    }
    else
    {
      // Clear the error message.
      Message.Text = "";
    }

  }

  void CustomersGridView_RowCancelingEdit(Object sender, GridViewCancelEditEventArgs e)
  {
    // Clear the error message.
    Message.Text = "";
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView PageIndexChanging Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView PageIndexChanging 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"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        onpageindexchanging="CustomersGridView_PageIndexChanging"
        onrowcancelingedit="CustomersGridView_RowCancelingEdit" 
        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]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

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



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft