FormView.AllowPaging プロパティ

定義

ページング機能が有効かどうかを示す値を取得または設定します。Gets or sets a value indicating whether the paging feature is enabled.

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

プロパティ値

ページング機能を有効にする場合は true。それ以外の場合は falsetrue to enable the paging feature; otherwise, false. 既定値は、false です。The default is false.

次の例は、 AllowPagingプロパティを使用して、 FormViewコントロールのページング機能を有効にする方法を示しています。The following example demonstrates how to use the AllowPaging property to enable the paging feature in a FormView control.


<%@ 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") %>&nbsp;<%# 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") %>&nbsp;<%# 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には、ユーザーがデータソース内の別のレコードに移動できるようにするためのページング機能が組み込まれています。The FormView control has built-in paging capabilities, which allow a user to navigate to a different record in the data source. ページング機能は、インターフェイスをSystem.Collections.ICollectionサポートする任意のデータソースオブジェクト、またはページング機能をサポートするデータソースで使用できます。The paging feature can be used with any data source object that supports the System.Collections.ICollection interface or a data source that supports paging capability.

ページング機能を有効にするにはAllowPaging 、プロパティtrueをに設定します。To enable the paging feature, set the AllowPaging property to true. PageCountプロパティを使用すると、基になるデータソース内の項目の合計数を確認できます。You can determine the total number of items in the underlying data source by using the PageCount property. 現在表示されている項目のインデックスを確認するPageIndexには、プロパティを使用します。To determine the index of the currently displayed item, use the PageIndex property.

ページングを有効にすると、ページャー行と呼ばれる追加の行がFormViewコントロールに自動的に表示されます。When paging is enabled, an additional row called the pager row is automatically displayed in the FormView control. ページャー行にはページナビゲーションコントロールが含まれており、コントロールの上部、下部、またはその両方に表示できます。The pager row contains the page navigation controls and can be displayed at the top, bottom, or both the top and bottom of the control. ポケットベルの行には、4つの組み込みのページャー表示モードがあります。The pager row has four built-in pager display modes. 次の表では、4つのモードについて説明します。The following table describes the four modes.

モードMode 説明Description
PagerButton.NextPrevious [戻る] ボタンと [次へ] ボタンで構成される改ページコントロールのセット。A set of pagination controls consisting of previous and next buttons.
PagerButton.NextPreviousFirstLast [戻る]、[次へ]、[最初へ]、[最後] の各ボタンで構成される改ページコントロールのセット。A set of pagination controls consisting of previous, next, first, and last buttons.
PagerButton.Numeric 直接ページにアクセスする番号付きリンク ボタンで構成されるページ編集コントロールのセット。A set of pagination controls consisting of numbered link buttons to access pages directly. これは既定のモードです。This is the default mode.
PagerButton.NumericFirstLast 番号付きおよび最初と最後のリンクボタンで構成される改ページコントロールのセット。A set of pagination controls consisting of numbered and first and last link buttons.

注意

データFormViewソースに含まれるレコードが2つ未満の場合、コントロールは自動的にポケットベルの行を非表示にします。The FormView control automatically hides the pager row when the data source contains fewer than two records.

PagerSettingsプロパティを使用して、ページャーの表示モード、一度に表示するページリンクの数、およびページャーコントロールのテキストラベルなど、ページャーの行の設定を制御できます。You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text label) by using the PagerSettings property. ページャー行の外観 (背景色とフォントの色を含む) を制御するには、 PagerStyleプロパティを使用します。To control the appearance of the pager row (including its background color and font color), use the PagerStyle property. コントロールFormViewでは、ページャー行のカスタムテンプレートを定義することもできます。The FormView control also allows you to define a custom template for the pager row. カスタムのページャー行テンプレートの作成の詳細についてPagerTemplateは、「」を参照してください。For more information on creating a custom pager row template, see PagerTemplate.

コントロールFormViewには、ページングが発生したときにカスタムアクションを実行するために使用できるいくつかのイベントが用意されています。The FormView control provides several events that you can use to perform a custom action when paging occurs. 次の表に、使用可能なイベントを示します。The following table lists the available events.

eventEvent 説明Description
PageIndexChanged ページャー ボタンの 1 つがクリックされた場合に、FormView コントロールがページング操作を処理した後に発生します。Occurs when one of the pager buttons is clicked, but after the FormView control handles the paging operation. このイベントは、ユーザーがコントロール内の別のレコードに移動した後にタスクを実行する必要がある場合によく使用されます。This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
PageIndexChanging ページャー ボタンの 1 つがクリックされた場合に、FormView コントロールがページング操作を処理する前に発生します。Occurs when one of the pager buttons is clicked, but before the FormView control handles the paging operation. このイベントは、ページング操作をキャンセルするためによく使用されます。This event is often used to cancel the paging operation.

注意

これらのイベントは、プログラムによってPageIndexプロパティを変更したときには発生しません。These events are not raised when you change the PageIndex property programmatically.

適用対象

こちらもご覧ください