GridView.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 ページング機能を宣言的に有効にする方法を GridView 示します。


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

注釈

データ ソース内のすべてのレコードを同時に表示する代わりに、コントロールはレコードを GridView ページに自動的に分割できます。 データ ソースがページング機能をサポートしている場合、 GridView コントロールはその機能を利用し、組み込みのページング機能を提供できます。 ページング機能は、インターフェイスをサポートする任意のデータ ソース オブジェクト、またはページング機能を System.Collections.ICollection サポートするデータ ソースと共に使用できます。

ページング機能を有効にするには、 プロパティを AllowPaging に true設定します。 既定では、コントロールは GridView 一度に 10 個のレコードをページに表示します。 プロパティを設定すると、ページに表示されるレコードの数を PageSize 変更できます。 データ ソースの内容を表示するために必要なページの合計数を確認するには、 プロパティを PageCount 使用します。 プロパティを使用して、現在表示されているページのインデックスを PageIndex 確認できます。

ページングを有効にすると、ページャー行と呼ばれる追加の行がコントロールに自動的に GridView 表示されます。 ポケットベル行には、ユーザーが他のページに移動できるようにするコントロールが含まれています。 プロパティを使用して、ページャー行の設定 (ページャーの表示モード、一度に表示するページ リンクの数、ページャー コントロールのテキスト ラベルなど) を PagerSettings 制御できます。 ポケットベル行は、 プロパティを設定することで、コントロールの上部、下部、または上下の両方に Position 表示できます。 また、 プロパティを設定 Mode して、4 つの組み込みポケットベル表示モードのいずれかを選択することもできます。 次の表では、組み込みの表示モードについて説明します。

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

ページャー行の外観 (背景色、フォントの色、位置など) を制御するには、 プロパティを PagerStyle 使用します。

Note

データ ソースにレコードが 1 ページしか含まれている場合、コントロールは GridView ページャー行を自動的に非表示にします。

GridViewコントロールを使用すると、ページャー行のカスタム テンプレートを定義することもできます。 カスタム ページャー行テンプレートの作成の詳細については、「」を参照してください PagerTemplate。

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

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

適用対象

こちらもご覧ください