FormView.AllowPaging プロパティ

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ページング機能が有効かどうかを示す値を取得または設定します。

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };

public virtual bool AllowPaging { get; set; }

member this.AllowPaging : bool with get, set

Public Overridable Property AllowPaging As Boolean

プロパティ値

Boolean

true ページング機能を有効にするには、それ以外の場合は false。既定値は、false です。

例

次の例では、 AllowPaging プロパティを使用して、 FormView コントロールのページング機能を有効にする方法を示します。


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

注釈

FormView コントロールには、ユーザーがデータソース内の別のレコードに移動できるようにするページング機能が組み込まれています。ページング機能は、 System.Collections.ICollection インターフェイスをサポートする任意のデータソースオブジェクト、またはページング機能をサポートするデータソースと共に使用できます。

ページング機能を有効にするには、 AllowPaging プロパティを true に設定します。 PageCount プロパティを使用して、基になるデータソース内の項目の合計数を確認できます。現在表示されている項目のインデックスを確認するには、 PageIndex プロパティを使用します。

ページングを有効にすると、ページャー行と呼ばれる追加の行が FormView コントロールに自動的に表示されます。ページャー行にはページナビゲーションコントロールが含まれており、コントロールの上部、下部、または上部と下部の両方に表示できます。ページャー行には、4 つの組み込みのポケットベル表示モードがあります。次の表では、4 つのモードについて説明します。

モード	説明
`PagerButton.NextPrevious`	前のボタンと次のボタンで構成される改ページコントロールのセット。
`PagerButton.NextPreviousFirstLast`	前、次、最初、最後の各ボタンで構成される改ページコントロールのセット。
`PagerButton.Numeric`	ページに直接アクセスするための番号付きリンクボタンで構成される改ページコントロールのセット。これは既定のモードです。
`PagerButton.NumericFirstLast`	番号付きリンクボタンと最初のリンクボタンと最後のリンクボタンで構成される改ページコントロールのセット。

注

データソースに含まれるレコードが 2 つ未満の場合、 FormView コントロールはページャー行を自動的に非表示にします。

PagerSettings プロパティを使用して、ページャー行の設定 (ポケットベル表示モード、一度に表示するページリンクの数、ページャーコントロールのテキストラベルなど) を制御できます。ページャー行の外観 (背景色とフォントの色を含む) を制御するには、 PagerStyle プロパティを使用します。 FormView コントロールでは、ポケットベル行のカスタムテンプレートを定義することもできます。カスタムページャー行テンプレートの作成の詳細については、「 PagerTemplate」を参照してください。

FormView コントロールには、ページングが発生したときにカスタムアクションを実行するために使用できるいくつかのイベントが用意されています。次の表に、使用可能なイベントの一覧を示します。

イベント	説明
PageIndexChanged	ページャーボタンのいずれかがクリックされたが、 FormView コントロールがページング操作を処理した後に発生します。このイベントは、ユーザーがコントロール内の別のレコードに移動した後にタスクを実行する必要がある場合に一般的に使用されます。
PageIndexChanging	ページャーボタンのいずれかがクリックされたが、 FormView コントロールがページング操作を処理する前に発生します。このイベントは、ページング操作を取り消すためによく使用されます。

注

PageIndex プロパティをプログラムで変更しても、これらのイベントは発生しません。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?