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

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

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

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

DetailsView.PageIndexChanging イベント

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

PageIndex プロパティの値が変更された場合に、ページング操作前に発生します。

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

Visual Basic (宣言)

Public Event PageIndexChanging As
 DetailsViewPageEventHandler

Visual Basic (使用法)

Dim instance As DetailsView
Dim handler As DetailsViewPageEventHandler

AddHandler instance.PageIndexChanging, handler

public event DetailsViewPageEventHandler PageIndexChanging

C++

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

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

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

JScript

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

解説

DetailsView コントロールは、コントロール内のページャボタン (CommandName プロパティが "Page" に設定されたボタン) がクリックされたときに、DetailsView コントロールでページング操作を処理する前に PageIndexChanging イベントを発生させます。これにより、このイベントが発生したときにカスタムルーチン (キャンセル操作やページング操作など) を実行するイベントハンドラを提供できます。

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

通常、ページャボタンは、DetailsView コントロールのページ行に配置されます。

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

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

使用例

PageIndexChanging イベントを使用して、ページング操作をキャンセルする方法のコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>

<script runat="server">


    Sub CustomerDetailView_ItemCommand(ByVal
 sender As Object, _
      ByVal e As DetailsViewCommandEventArgs)
        ' Clear the error message if the user cancels the edit 
        ' operation.
        If e.CommandName = "Cancel"
 Then
            ErrorMessageLabel.Text = ""
        End If
    End Sub

    Protected Sub CustomerDetailView_PageIndexChanging(
 _
    ByVal sender As Object,
 ByVal e As DetailsViewPageEventArgs)
        ' Cancel the paging operation if the user tries to navigate
 
        ' to another record while in edit mode.
        If CustomerDetailView.CurrentMode = DetailsViewMode.Edit
 Then
            e.Cancel = True
            ' Display an error message.
            ErrorMessageLabel.Text = _
                "You cannot navigate to another record while in
 edit mode."
        End If
    End Sub
</script>

<html>
<body>
    <form id="Form1" runat="server">
        <h3>
            DetailsView CurrentMode Example</h3>
        <asp:DetailsView ID="CustomerDetailView"
 
          DataSourceID="DetailsViewSource" 
          AutoGenerateRows="true"
          AutoGenerateEditButton="true" 
          DataKeyNames="CustomerID" 
          GridLines="Both" 
          AllowPaging="true"
          OnItemCommand="CustomerDetailView_ItemCommand"
 
          runat="server" 
          OnPageIndexChanging="CustomerDetailView_PageIndexChanging">
          
          <HeaderStyle BackColor="Navy" ForeColor="White"
 />
        </asp:DetailsView>
        
        <br />
        
        <asp:Label ID="ErrorMessageLabel" 
          ForeColor="Red" runat="server"
 />
        
        <!-- 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="DetailsViewSource"
 runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
</body>
</html>

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

<script runat="server">


    void CustomerDetailView_ItemCommand(Object sender, 
      DetailsViewCommandEventArgs e)
    {
        // Clear the error message if the user cancels the edit 
        // operation.
        if (e.CommandName == "Cancel")
        {
            ErrorMessageLabel.Text = "";
        }
    }

    protected void CustomerDetailView_PageIndexChanging(
      object sender, DetailsViewPageEventArgs e)
    {
        // Cancel the paging operation if the user tries to 
        // navigate to another record while in edit mode.
        if (CustomerDetailView.CurrentMode == DetailsViewMode.Edit)
        {
            e.Cancel = true;
            // Display an error message.
            ErrorMessageLabel.Text = 
              "You cannot navigate to another record while
 in edit mode.";
        }

    }
</script>

<html>
<body>
    <form id="Form1" runat="server">
        <h3>
            DetailsView CurrentMode Example</h3>
        <asp:DetailsView ID="CustomerDetailView" 
          DataSourceID="DetailsViewSource" 
          AutoGenerateRows="true"
          AutoGenerateEditButton="true" 
          DataKeyNames="CustomerID" 
          GridLines="Both" 
          AllowPaging="true"
          OnItemCommand="CustomerDetailView_ItemCommand" 
          runat="server" 
          OnPageIndexChanging="CustomerDetailView_PageIndexChanging">
          
          <HeaderStyle BackColor="Navy" ForeColor="White"
 />
        </asp:DetailsView>
        
        <br />
        
        <asp:Label ID="ErrorMessageLabel" 
          ForeColor="Red" runat="server" />
        
        <!-- 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="DetailsViewSource" runat="server"
 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </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

参照

関連項目
DetailsView クラス
DetailsView メンバ
System.Web.UI.WebControls 名前空間
DetailsViewPageEventArgs
DetailsViewPageEventArgs
Cancel
NewPageIndex
OnPageIndexChanging
その他の技術情報
イベントの利用

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

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

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

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

DetailsView.PageIndexChanging イベント

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


	© 2025 Microsoft.All rights reserved.

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

DetailsView.PageIndexChanging イベント

急上昇のことば

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

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