Exportieren (0) Drucken
Alle erweitern

GridViewPageEventArgs-Klasse

Hinweis: Diese Klasse ist neu in .NET Framework, Version 2.0.

Stellt Daten für das PageIndexChanging-Ereignis bereit.

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

public class GridViewPageEventArgs : CancelEventArgs
public class GridViewPageEventArgs extends CancelEventArgs
public class GridViewPageEventArgs extends CancelEventArgs

Das GridView-Steuerelement löst das PageIndexChanging-Ereignis aus, wenn auf eine Pagerschaltfläche (eine Schaltfläche, deren CommandName-Eigenschaft auf "Page" festgelegt ist) innerhalb des Steuerelements geklickt wird. Dabei wird das Ereignis ausgelöst, bevor das GridView-Steuerelement den Pagingvorgang behandelt. Dadurch können Sie eine Ereignisbehandlungsmethode bereitstellen, die bei jedem Auftreten dieses Ereignisses eine benutzerdefinierte Routine ausführt, beispielsweise den Abbruch des Pagingvorgangs.

HinweisHinweis

Pagerschaltflächen befinden sich normalerweise in der Pagerzeile eines GridView-Steuerelements.

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 CancelEventArgs.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.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von GridViewPageEventArgs finden Sie unter dem GridViewPageEventArgs-Konstruktor.

Das folgende Beispiel veranschaulicht, wie mit dem an die Ereignisbehandlungsmethode übergebenen GridViewPageEventArgs-Objekt der Index der durch den Benutzer ausgewählten Seite ermittelt und der Pagingvorgang abgebrochen werden kann.


<%@ Page language="C#" %>

<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>
  <body>
    <form 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>


System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.GridViewPageEventArgs

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen:
© 2015 Microsoft