NumericPagerField クラス

定義

ユーザーがページ番号によってページを選択できるようにする DataPager フィールドを表します。

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
継承
NumericPagerField

次の例は、オブジェクトを NumericPagerField 使用して、コントロールに表示されるデータをページングする方法を ListView 示しています。

<%@ 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

注釈

クラスは NumericPagerField 、コントロール内のナビゲーション コントロールを DataPager 表示します。 コントロールは、 コントロールなどのListViewインターフェイスを実装するコントロールによって表示されるデータをIPageableItemContainerページングするために使用できます。 オブジェクトは NumericPagerField 、ユーザーがクリックして特定のページに移動できるボタンとしてページ番号を表示します。 コントロールには、ユーザーがコントロールに表示されるページよりも多くのデータ ページにアクセスできるようにする次ページボタンと前ページ ボタンも表示されます。

次の表に示すプロパティを NumericPagerField 使用して、オブジェクトの外観をカスタマイズできます。

プロパティ [説明]
CurrentPageLabelCssClass 現在のページ番号の CSS クラス。
NextPreviousButtonCssClass 次ページ ボタンと前ページ ボタンの CSS クラス。
NumericButtonCssClass ページ番号を表すボタンの CSS クラス。

プロパティを ButtonType 使用して、表示されるボタンの種類を選択できます。 次の表に、使用可能なボタンの種類を示します。

[ボタンの種類] [説明]
ButtonType.Button Button コントロール。
ButtonType.Image ImageButton コントロール。
ButtonType.Link LinkButton コントロール。

オブジェクト内の NumericButtonCssClass コントロールは、それらの間に区切りのないスペースでレンダリングされます。 この動作をカスタマイズする場合は、 プロパティを RenderNonBreakingSpacesBetweenControls 使用できます。

コントロール内のオブジェクトをNumericPagerFieldDataPager非表示にするには、 プロパティを Visiblefalse設定します。 次ページ ボタンと前ページ ボタンの表示を制御することはできません。 関連付けられたデータ コントロールに追加のページが表示可能な場合は、コントロールによって表示されます。 プロパティを ButtonCount 使用すると、オブジェクトに表示されるボタンの数を NumericPagerField 指定できます。 各ボタンはページ番号に対応します。

プロパティを設定することで、次ページ ボタンのテキストを NextPageText 設定できます。 前のページ ボタンのテキストは、 PreviousPageText プロパティを使用して設定できます。

プロパティが ButtonTypeButtonType.Image設定されている場合は、次のページボタンと前のページ ボタンに表示されるイメージの URL を指定する必要があります。 これを行うには、 プロパティと PreviousPageImageUrl プロパティをNextPageImageUrl設定します。 その場合は、対応する text プロパティが画像の代替テキストとして使用されます。 たとえば、 プロパティで NextPageImageUrl 指定されたテキストは、次ページの画像ボタンの代替テキストとして表示されます。 ヒントをサポートするブラウザーでは、このテキストは対応するボタンのヒントとしても表示されます。

コンストラクター

NumericPagerField()

NumericPagerField クラスの新しいインスタンスを初期化します。

プロパティ

ButtonCount

NumericPagerField オブジェクトで表示するボタンの数を取得または設定します。

ButtonType

ページャー フィールドに表示するボタンの種類を取得または設定します。

CurrentPageLabelCssClass

現在のページ番号のスタイルを設定するために使用する、カスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。

DataPager

DataPagerField オブジェクトが関連付けられているデータ ページャーへの参照を取得します。

(継承元 DataPagerField)
IsTrackingViewState

DataPagerField オブジェクトでビューステートの変化を追跡しているかどうかを示す値を取得します。

(継承元 DataPagerField)
NextPageImageUrl

NumericPagerField オブジェクトで、次のページに移動するボタンとして表示するイメージの URL を取得または設定します。

NextPageText

次のページに移動するボタンに表示されるテキストを取得または設定します。

NextPreviousButtonCssClass

次のページおよび前のページに移動するページャー フィールドのボタンのスタイルを設定するために使用する、カスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。

NumericButtonCssClass

ページャー フィールドのページ番号ボタンのスタイルを設定するために使用する、カスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。

PreviousPageImageUrl

NumericPagerField オブジェクトで、前のページに移動するボタンとして表示するイメージの URL を取得または設定します。

PreviousPageText

前のページに移動するボタンに表示されるテキストを取得または設定します。

QueryStringHandled

クエリ文字列フィールドが評価されたかどうかを示す値を取得または設定します。

(継承元 DataPagerField)
QueryStringValue

要求の URL からクエリ文字列フィールドの値を取得します。

(継承元 DataPagerField)
RenderNonBreakingSpacesBetweenControls

コントロール間に非区切りスペースを表示するかどうかを示す値を取得または設定します。

ViewState

同一のページに対する複数の要求にわたって、DataPagerField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

(継承元 DataPagerField)
Visible

データ ページャー フィールドを表示するかどうかを示す値を取得または設定します。

(継承元 DataPagerField)

メソッド

CloneField()

DataPagerField から派生した現在のオブジェクトのコピーを作成します。

(継承元 DataPagerField)
CopyProperties(DataPagerField)

NumericPagerField オブジェクトの現在のプロパティを、指定された DataPagerField オブジェクトにコピーします。

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

ページャー フィールド オブジェクトのユーザー インターフェイス (UI) コントロールを作成し、指定のコンテナーに追加します。

CreateField()

NumericPagerField クラスの新しいインスタンスを作成して返します。

Equals(Object)

指定したオブジェクトが、現在の NumericPagerField オブジェクトと等しいかどうかを判断します。

GetHashCode()

NumericPagerField クラスのハッシュ関数として機能します。

GetQueryStringNavigateUrl(Int32)

指定のページ番号を持つクエリ文字列フィールドが含まれる URL を作成します。

(継承元 DataPagerField)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
HandleEvent(CommandEventArgs)

NumericPagerField オブジェクトで発生するイベントを処理し、適切なアクションを実行します。

LoadViewState(Object)

以前に保存したビューステート情報を復元します。

(継承元 DataPagerField)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnFieldChanged()

FieldChanged イベントを発生させます。

(継承元 DataPagerField)
SaveViewState()

DataPagerField オブジェクトのビューステートに加えられた変更を保存します。

(継承元 DataPagerField)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TrackViewState()

DataPagerField オブジェクトがそのビューステートの変更を追跡するようにします。これにより、変更をコントロールの ViewState プロパティに格納し、同じページに対する複数の要求の間で保持できるようになります。

(継承元 DataPagerField)

明示的なインターフェイスの実装

IStateManager.IsTrackingViewState

DataPagerField オブジェクトでビューステートの変化を追跡しているかどうかを示す値を取得します。

(継承元 DataPagerField)
IStateManager.LoadViewState(Object)

以前に保存したビューステート情報を復元します。

(継承元 DataPagerField)
IStateManager.SaveViewState()

DataPagerField オブジェクトのビューステートに加えられた変更を保存します。

(継承元 DataPagerField)
IStateManager.TrackViewState()

DataPagerField オブジェクトがそのビューステートの変更を追跡するようにします。これにより、変更をコントロールの ViewState プロパティに格納し、同じページに対する複数の要求の間で保持できるようになります。

(継承元 DataPagerField)

適用対象

こちらもご覧ください