Questo argomento non è stato ancora valutato - Valuta questo argomento

Evento GridView.PageIndexChanged

.NET Framework 3.5

Aggiornamento: novembre 2007

Si verifica quando viene fatto clic su uno dei pulsanti di spostamento, ma dopo che il controllo GridView ha gestito l'operazione di spostamento.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Sintassi

C++

public event EventHandler PageIndexChanged

/** @event */
public void add_PageIndexChanged (EventHandler value)
/** @event */
public void remove_PageIndexChanged (EventHandler value)

JScript

JScript non supporta gli eventi.

ASP.NET

<asp:GridView OnPageIndexChanged="EventHandler" />

Note

L'evento PageIndexChanged viene generato quando viene fatto clic su uno dei pulsanti di spostamento, ma dopo che il controllo GridView ha gestito l'operazione di spostamento. In questo modo è possibile fornire un metodo di gestione degli eventi in grado di eseguire una routine personalizzata, ad esempio un'operazione di spostamento personalizzata, ogni volta che si verifica l'evento.

Per determinare l'indice della pagina selezionata dall'utente, utilizzare la proprietà PageIndex del controllo GridView.

Per ulteriori informazioni sulla gestione degli eventi, vedere Utilizzo degli eventi.

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare l'evento PageIndexChanged per la visualizzazione del numero di pagina selezionato dall'utente dalla riga di spostamento.


<%@ 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>

Piattaforme

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 e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione