Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

GridView.PageIndexChanging-Ereignis

.NET Framework 3.5

Aktualisiert: November 2007

Tritt ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings bevor das GridView-Steuerelement den Pagingvorgang behandelt.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

public event GridViewPageEventHandler PageIndexChanging

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

JScript

JScript unterstützt keine Ereignisse.

ASP.NET

<asp:GridView OnPageIndexChanging="GridViewPageEventHandler" />

Hinweise

Das PageIndexChanging-Ereignis wird aufgerufen, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings bevor das GridView-Steuerelement den Pagingvorgang tatsächlich behandelt. Dadurch können Sie eine Ereignisbehandlungsmethode bereitstellen, die bei jedem Auftreten dieses Ereignisses eine benutzerdefinierte Routine ausführt, beispielsweise den Abbruch des Pagingvorgangs.

Hinweis:
Dieses Ereignis wird nicht ausgelöst, wenn Sie die PageIndex-Eigenschaft programmgesteuert festlegen.

Ein GridViewPageEventArgs-Objekt wird an die Ereignisbehandlungsmethode weitergegeben. Dadurch können Sie den Index der vom Benutzer ausgewählten Seite ermitteln und angeben, dass der Pagingvorgang abgebrochen werden soll. Legen Sie die Cancel-Eigenschaft des GridViewPageEventArgs-Objekts auf true fest, um den Pagingvorgang abzubrechen.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie mit dem PageIndexChanging-Ereignis der Pagingvorgang abgebrochen wird, wenn der Benutzer versucht, zu einer anderen Seite zu navigieren, während sich das GridView-Steuerelement im Bearbeitungsmodus befindet.


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

Plattformen

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 und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen