DetailsViewPageEventArgs クラスとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > DetailsViewPageEventArgs クラスの意味・解説 

DetailsViewPageEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0新しく追加されたものです。

PageIndexChanging イベントデータ提供します

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

Public Class DetailsViewPageEventArgs
    Inherits CancelEventArgs
Dim instance As DetailsViewPageEventArgs
public class DetailsViewPageEventArgs : CancelEventArgs
public ref class DetailsViewPageEventArgs :
 public CancelEventArgs
public class DetailsViewPageEventArgs extends
 CancelEventArgs
public class DetailsViewPageEventArgs extends
 CancelEventArgs
解説解説

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

メモメモ

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

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

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

DetailsViewPageEventArgs クラスインスタンス初期プロパティ値の一覧については、DetailsViewPageEventArgs コンストラクタトピック参照してください

使用例使用例

PageIndexChanging イベントイベント ハンドラ渡される DetailsViewPageEventArgs オブジェクト使用してDetailsView コントロール編集モードになっているときにユーザー別のページ移動しようとした場合ページング操作キャンセルする方法コード例次に示します

<%@ Page language="VB" %>

<script runat="server">
  
  Sub CustomerDetailsView_PageIndexChanging(ByVal
 sender As Object, ByVal
 e As DetailsViewPageEventArgs)
  
    ' Cancel the paging operation if the DetailsView control 
    ' in edit mode.
    If CustomerDetailsView.CurrentMode = DetailsViewMode.Edit
 Then
    
      e.Cancel = True
      
      ' Display an error message.
      Dim newPage As Integer
 = e.NewPageIndex + 1
      MessageLabel.Text = "Please update the current record before
 to moving to page " & _
        newPage.ToString() & "."
    
    End If
      
  End Sub

  Sub CustomerDetailsView_ModeChanging(ByVal
 sender As Object, ByVal
 e As DetailsViewModeEventArgs)
  
    ' Clear the message label when the user cancels edit mode.
    If e.CancelingEdit Then
    
      MessageLabel.Text = ""
    
    End If
      
  End Sub
  
</script>

<html>

  <body>
    <form runat="server">
        
      <h3>DetailsViewPageEventArgs Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          autogenerateeditbutton="true"
          datakeynames="CustomerID"   
          allowpaging="true"
          onpageindexchanging="CustomerDetailsView_PageIndexChanging"
 
          onmodechanging="CustomerDetailsView_ModeChanging"
          runat="server">
            
          <pagersettings position="Bottom"/>
 
                    
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          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"
          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 CustomerDetailsView_PageIndexChanging(Object sender, DetailsViewPageEventArgs
 e)
  {
    // Cancel the paging operation if the DetailsView control 
    // in edit mode.
    if (CustomerDetailsView.CurrentMode == DetailsViewMode.Edit)
    {
      e.Cancel = true;
      
      // Display an error message.
      int newPage = e.NewPageIndex + 1;
      MessageLabel.Text = "Please update the current record before to moving
 to page " + 
        newPage.ToString() + ".";
    }
  }

  void CustomerDetailsView_ModeChanging(Object sender, DetailsViewModeEventArgs
 e)
  {
    // Clear the message label when the user cancels edit mode.
    if (e.CancelingEdit)
    {
      MessageLabel.Text = "";
    }
  }
  
</script>

<html>

  <body>
    <form runat="server">
        
      <h3>DetailsViewPageEventArgs Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          autogenerateeditbutton="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          onpageindexchanging="CustomerDetailsView_PageIndexChanging" 
          onmodechanging="CustomerDetailsView_ModeChanging"
          runat="server">
            
          <pagersettings position="Bottom"/> 
                    
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          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"
          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>

.NET Framework のセキュリティ.NET Frameworkセキュリティ
継承階層継承階層
System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.DetailsViewPageEventArgs
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
DetailsViewPageEventArgs メンバ
System.Web.UI.WebControls 名前空間
DetailsView クラス
DetailsViewPageEventHandler
CancelEventArgs
DetailsView.PageIndexChanging イベント
Cancel
NewPageIndex
OnPageIndexChanging



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「DetailsViewPageEventArgs クラス」の関連用語

DetailsViewPageEventArgs クラスのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



DetailsViewPageEventArgs クラスのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS