FormView.AllowPaging プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

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

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

注意

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

適用対象

こちらもご覧ください