GridView.PageIndexChanging イベントとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GridView.PageIndexChanging イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ページャボタンの 1 つがクリックされた場合に、GridView コントロールがページング操作を処理する前に発生します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Event PageIndexChanging As
 GridViewPageEventHandler

Visual Basic (使用法)

Dim instance As GridView
Dim handler As GridViewPageEventHandler

AddHandler instance.PageIndexChanging, handler

public event GridViewPageEventHandler PageIndexChanging

C++

public:
event GridViewPageEventHandler^ PageIndexChanging {
    void add (GridViewPageEventHandler^ value);
    void remove (GridViewPageEventHandler^ value);
}

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

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

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

PageIndexChanging イベントは、いずれかのページャボタンがクリックされた場合に、GridView コントロールがページング操作を処理する前に発生します。これにより、このイベントが発生するたびにカスタムルーチン (ページング操作のキャンセルなど) を実行するイベント処理メソッドを提供できます。

メモ
プログラムによって PageIndex プロパティを設定した場合、このイベントは発生しません。

GridViewPageEventArgs オブジェクトがイベント処理メソッドに渡されることにより、ユーザーが選択したページのインデックスを確認したり、ページング操作をキャンセルする必要があることを示したりできます。ページング操作をキャンセルするには、GridViewPageEventArgs オブジェクトの Cancel プロパティを true に設定します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

PageIndexChanging イベントを使用して、GridView コントロールが編集モードのときにユーザーが別のページに移動しようとした場合に、ページング操作をキャンセルする方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CustomersGridView_PageIndexChanging(ByVal
 sender As Object, ByVal
 e As GridViewPageEventArgs)
    
    ' 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 Then
    
      ' Use the Cancel property to cancel the paging operation.
      e.Cancel = True
      
      ' Display an error message.
      Dim newPageNumber As Integer
 = e.NewPageIndex + 1
      Message.Text = "Please update the record before moving to
 page " & _
        newPageNumber.ToString() & "."
    
    Else
    
      ' Clear the error message.
      Message.Text = ""
    
    End If
    
  End Sub

  Sub CustomersGridView_RowCancelingEdit(ByVal
 sender As Object, ByVal
 e As GridViewCancelEditEventArgs)
  
    ' Clear the error message.
    Message.Text = ""
    
  End Sub

</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>

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridView クラス
GridView メンバ
System.Web.UI.WebControls 名前空間
GridView.AllowPaging プロパティ
GridViewPageEventArgs
OnPageIndexChanging
GridView.PageIndexChanged イベント
OnPageIndexChanged
その他の技術情報
イベントの利用

このページでは「.NET Framework クラスライブラリリファレンス」からGridView.PageIndexChanging イベントを検索した結果を表示しています。
Weblioに収録されているすべての辞書からGridView.PageIndexChanging イベントを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からGridView.PageIndexChanging イベントを検索

>> 「GridView.PageIndexChanging イベント」を含む用語の索引
GridView.PageIndexChanging イベントのページへのリンク

GridView.PageIndexChanging イベントとは？わかりやすく解説

GridView.PageIndexChanging イベント

「GridView.PageIndexChanging イベント」の関連用語


	© 2025 Microsoft.All rights reserved.

GridView.PageIndexChanging イベントとは？ わかりやすく解説

GridView.PageIndexChanging イベント

急上昇のことば

「GridView.PageIndexChanging イベント」の関連用語

GridView.PageIndexChanging イベントとは？わかりやすく解説