GridView.AllowPaging プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GridView.AllowPaging プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Overridable Property
 AllowPaging As Boolean

Visual Basic (使用法)

Dim instance As GridView
Dim value As Boolean

value = instance.AllowPaging

instance.AllowPaging = value

public virtual bool AllowPaging { get;
 set; }

C++

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

/** @property */
public boolean get_AllowPaging ()

/** @property */
public void set_AllowPaging (boolean value)

JScript

public function get AllowPaging
 () : boolean

public function set AllowPaging
 (value : boolean)

プロパティ値
ページング機能が有効な場合は true。それ以外の場合は false。既定値は false です。

解説

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

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

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

モード	説明
PagerButton.NextPrevious	戻るボタンと次へボタンで構成されるページ編集コントロールセット。
PagerButton.NextPreviousFirstLast	前へ、次へ、先頭、末尾の各ボタンで構成されるページ編集コントロールセット。
PagerButton.Numeric	直接ページにアクセスするための番号付きリンクボタンで構成されるページ編集コントロールセット。これは、既定のモードです。
PagerButton.NumericFirstLast	番号付き、先頭、および末尾の各リンクボタンで構成されるページ編集コントロールセット。

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

メモ
データソースに 1 つ以下のレコードしか格納されていない場合、GridView コントロールは、自動的にページ行を非表示にします。

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

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

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

Topic	Location
方法 : GridView Web サーバーコントロールで既定のページングを有効にする	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

AllowPaging プロパティを使用して、GridView コントロールのページング機能を宣言によって有効にする方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form 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="C#" %>

<html>
  <body>
    <form 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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridView クラス
GridView メンバ
System.Web.UI.WebControls 名前空間
System.Web.UI.WebControls.PagerSettings
System.Web.UI.WebControls.TableItemStyle
PageCount
PageIndex
PagerSettings
PagerStyle
PagerTemplate
PageSize
PageIndexChanged
PageIndexChanging

このページでは「.NET Framework クラスライブラリリファレンス」からGridView.AllowPaging プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からGridView.AllowPaging プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からGridView.AllowPaging プロパティを検索

>> 「GridView.AllowPaging プロパティ」を含む用語の索引
GridView.AllowPaging プロパティのページへのリンク

GridView.AllowPaging プロパティとは？わかりやすく解説

GridView.AllowPaging プロパティ

「GridView.AllowPaging プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

GridView.AllowPaging プロパティとは？ わかりやすく解説

GridView.AllowPaging プロパティ

急上昇のことば

「GridView.AllowPaging プロパティ」の関連用語

GridView.AllowPaging プロパティとは？わかりやすく解説