NumericPagerField クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.Extensions.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザーがページ番号によってページを選択できるようにする 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

継承: Object

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 使用できます。

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

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

プロパティが ButtonType に ButtonType.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)

適用対象

NumericPagerField クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

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

適用対象

こちらもご覧ください

フィードバック

その他のリソース