NextPreviousPagerField NextPreviousPagerField NextPreviousPagerField NextPreviousPagerField Class

定義

ユーザーがデータのページ切り替えができるように、DataPager コントロール内のナビゲーション コントロールを表示するフィールドを表します。Represents a field that displays navigation controls in a DataPager control enable users to page through data.

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

次の例は、使用する方法を示します、NextPreviousPagerFieldのページで表示されるデータを移動するオブジェクト、ListViewコントロール。The following example shows how to use a NextPreviousPagerField object to page through data that is displayed in a ListView 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 id="Head1" runat="server">
    <title>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>

注釈

NextPreviousPagerFieldクラス内のナビゲーション コントロールを表示するフィールドを表す、DataPagerコントロール。The NextPreviousPagerField class represents a field that displays navigation controls in a DataPager control. これらのナビゲーション コントロールを使用するページを実装するコントロールによって表示されるデータを移動する、IPageableItemContainerインターフェイスなど、ListViewコントロール。These navigation controls can be used to page through data that are displayed by a control that implements the IPageableItemContainer interface, such as the ListView control.

NextPreviousPagerFieldクラスには、一度に 1 ページのページ間を移動するデータの最初と最後のページに直接移動したりできるようにするためのボタンが用意されています。The NextPreviousPagerField class provides buttons that enable users to navigate through the pages of data one page at a time, or to jump to the first or last page of data.

外観をカスタマイズすることができます、NextPreviousPagerFieldオブジェクトを使用して、ButtonCssClassボタンのスタイルを設定するプロパティ。You can customize the appearance of the NextPreviousPagerField object by using the ButtonCssClass property to set the style of the buttons. 使用することも、ButtonTypeプロパティが表示されるボタンの種類を選択します。You can also use the ButtonType property to choose the type of button that is displayed. 次の表では、使用可能なボタンの種類を示します。The following table lists the available button types.

[ボタンの種類]Button type 説明Description
Button Button コントロール。A Button control.
Image ImageButton コントロール。An ImageButton control.
Link LinkButton コントロール。A LinkButton control.

非表示にすることができます、NextPreviousPagerFieldオブジェクト、DataPagerコントロールを設定して、Visibleプロパティをfalseします。You can hide a NextPreviousPagerField object in a DataPager control by setting the Visible property to false. 設定して、個々 のボタン (最初のページ、前のページ、次のページ、および最後のページ ボタン) を隠すことも、 ShowFirstPageButtonShowPreviousPageButtonShowNextPageButton、およびShowLastPageButtonプロパティfalseします。You can also hide the individual buttons (the first-page, previous-page, next-page, and last-page buttons) by setting the ShowFirstPageButton, ShowPreviousPageButton, ShowNextPageButton, and ShowLastPageButton properties to false.

NextPreviousPagerFieldコントロールを使用してカスタムのテキストの各ボタンを指定することができます、 FirstPageTextPreviousPageTextNextPageText、およびLastPageTextプロパティ。The NextPreviousPagerField control enables you to specify custom text for each button by using the FirstPageText, PreviousPageText, NextPageText, and LastPageText properties.

ときに、ButtonTypeプロパティに設定されてButtonType.Imageボタンに表示されるイメージの URL を指定する必要があります。When the ButtonType property is set to ButtonType.Image, you must provide the URL to an image that will be displayed for the button. 各ボタンの個別のイメージを設定するには、設定をFirstPageImageUrlPreviousPageImageUrlNextPageImageUrl、およびLastPageImageUrlプロパティ。You can set images individually for each button by setting the FirstPageImageUrl, PreviousPageImageUrl, NextPageImageUrl, and LastPageImageUrl properties.

ときに、ButtonTypeプロパティに設定されてButtonType.Image、対応するテキスト プロパティは、イメージの代替テキストとして機能します。When the ButtonType property is set to ButtonType.Image, the corresponding text property acts as the alternate text for the image. たとえば、テキストで指定されている、FirstPageTextプロパティは、最初のページ イメージ ボタンの代替テキストとして表示されます。For example, the text that is specified by the FirstPageText property is displayed as the alternate text for the first-page image button. ツールヒントをサポートするブラウザーでは、このテキストはツールヒントとしても表示されます。In browsers that support tooltips, this text is also displayed as a tooltip.

コンストラクター

NextPreviousPagerField() NextPreviousPagerField() NextPreviousPagerField() NextPreviousPagerField()

NextPreviousPagerField クラスの新しいインスタンスを初期化します。Initializes a new instance of the NextPreviousPagerField class.

プロパティ

ButtonCssClass ButtonCssClass ButtonCssClass ButtonCssClass

ブラウザーでページャー フィールドのボタンの表示に使用するカスケード スタイル シート (CSS: Cascading Style Sheet) クラスを取得または設定します。Gets or sets the cascading style sheet (CSS) class that is used to render the buttons of the pager field on the browser.

ButtonType ButtonType ButtonType ButtonType

ページャー フィールドに表示するボタンの種類を取得または設定します。Gets or sets the button type to display in the pager field.

DataPager DataPager DataPager DataPager

DataPagerField オブジェクトが関連付けられているデータ ページャーへの参照を取得します。Gets a reference to the data pager that the DataPagerField object is associated with.

(Inherited from DataPagerField)
FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl

最初のページに移動するボタン用に表示するイメージの URL を取得または設定します。Gets or sets the URL to an image that is displayed for the first-page button.

FirstPageText FirstPageText FirstPageText FirstPageText

最初のページに移動するボタンに表示されるテキストを取得または設定します。Gets or sets the text that is displayed for the first-page button.

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

DataPagerField オブジェクトでビューステートの変化を追跡しているかどうかを示す値を取得します。Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

(Inherited from DataPagerField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

DataPagerField オブジェクトでビューステートの変化を追跡しているかどうかを示す値を取得します。Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

(Inherited from DataPagerField)
LastPageImageUrl LastPageImageUrl LastPageImageUrl LastPageImageUrl

NextPreviousPagerField オブジェクトで最後のページに移動するボタン用に表示するイメージの URL を取得または設定します。Gets or sets the URL to an image that is displayed for the last-page button in the NextPreviousPagerField object.

LastPageText LastPageText LastPageText LastPageText

最後のページに移動するボタンに表示されるテキストを取得または設定します。Gets or sets the text that is displayed for the last-page button.

NextPageImageUrl NextPageImageUrl NextPageImageUrl NextPageImageUrl

NextPreviousPagerField オブジェクトで次のページに移動するボタン用に表示するイメージの URL を取得または設定します。Gets or sets the URL to an image that is displayed for the next-page button in the NextPreviousPagerField object.

NextPageText NextPageText NextPageText NextPageText

次のページに移動するボタンに表示されるテキストを取得または設定します。Gets or sets the text that is displayed for the next-page button.

PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl

NextPreviousPagerField オブジェクトで前のページに移動するボタン用に表示するイメージの URL を取得または設定します。Gets or sets the URL to an image that is displayed for the previous-page button in the NextPreviousPagerField object.

PreviousPageText PreviousPageText PreviousPageText PreviousPageText

前のページに移動するボタンに表示されるテキストを取得または設定します。Gets or sets the text that is displayed for the previous-page button.

QueryStringHandled QueryStringHandled QueryStringHandled QueryStringHandled

クエリ文字列フィールドが評価されたかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the query string field has been evaluated.

(Inherited from DataPagerField)
QueryStringValue QueryStringValue QueryStringValue QueryStringValue

要求の URL からクエリ文字列フィールドの値を取得します。Gets the value of the query string field from the URL of the request.

(Inherited from DataPagerField)
RenderDisabledButtonsAsLabels RenderDisabledButtonsAsLabels RenderDisabledButtonsAsLabels RenderDisabledButtonsAsLabels

無効なボタンを Label コントロールとして NextPreviousPagerField オブジェクトに表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether disabled buttons are rendered as Label controls by the NextPreviousPagerField object.

RenderNonBreakingSpacesBetweenControls RenderNonBreakingSpacesBetweenControls RenderNonBreakingSpacesBetweenControls RenderNonBreakingSpacesBetweenControls

コントロールの間に非区切りスペースを表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether non-breaking spaces are rendered between controls.

ShowFirstPageButton ShowFirstPageButton ShowFirstPageButton ShowFirstPageButton

最初のページに移動するボタンが NextPreviousPagerField オブジェクトに表示されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the first-page button is displayed in a NextPreviousPagerField object.

ShowLastPageButton ShowLastPageButton ShowLastPageButton ShowLastPageButton

最後のページに移動するボタンが NextPreviousPagerField オブジェクトに表示されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the last-page button is displayed in a NextPreviousPagerField object.

ShowNextPageButton ShowNextPageButton ShowNextPageButton ShowNextPageButton

次のページに移動するボタンが NextPreviousPagerField オブジェクトに表示されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the next-page button is displayed in a NextPreviousPagerField object.

ShowPreviousPageButton ShowPreviousPageButton ShowPreviousPageButton ShowPreviousPageButton

前のページに移動するボタンが NextPreviousPagerField オブジェクトに表示されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the previous-page button is displayed in a NextPreviousPagerField object.

ViewState ViewState ViewState ViewState

同一のページに対する複数の要求にわたって、DataPagerField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。Gets a dictionary of state information that enables you to save and restore the view state of a DataPagerField object across multiple requests for the same page.

(Inherited from DataPagerField)
Visible Visible Visible Visible

データ ページャー フィールドを表示するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether a data pager field is rendered.

(Inherited from DataPagerField)

メソッド

CloneField() CloneField() CloneField() CloneField()

DataPagerField から派生した現在のオブジェクトのコピーを作成します。Creates a copy of the current object that is derived from DataPagerField.

(Inherited from DataPagerField)
CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField)

NextPreviousPagerField オブジェクトの現在のプロパティを、指定された DataPagerField オブジェクトにコピーします。Copies the properties of the current NextPreviousPagerField object to the specified DataPagerField object.

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

ページャー フィールド オブジェクトのユーザー インターフェイス (UI) コントロールを作成し、指定のコンテナーに追加します。Creates the user interface (UI) controls for the pager field object and adds them to the specified container.

CreateField() CreateField() CreateField() CreateField()

NextPreviousPagerField クラスの新しいインスタンスを作成して返します。Creates and returns a new instance of the NextPreviousPagerField class.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在の NextPreviousPagerField オブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current NextPreviousPagerField object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

NextPreviousPagerField クラスのハッシュ関数として機能します。Serves as a hash function for the NextPreviousPagerField class.

GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32)

指定のページ番号を持つクエリ文字列フィールドが含まれる URL を作成します。Creates a URL that contains a query string field that has the specified page number.

(Inherited from DataPagerField)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs)

NextPreviousPagerField コントロールで発生するイベントを処理し、適切なアクションを実行します。Handles events that occur in the NextPreviousPagerField control and performs the appropriate action.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

以前に保存したビューステート情報を復元します。Restores view-state information that was saved previously.

(Inherited from DataPagerField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

FieldChanged イベントを発生させます。Raises the FieldChanged event.

(Inherited from DataPagerField)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

DataPagerField オブジェクトのビューステートに加えられた変更を保存します。Saves the changes that were made to the DataPagerField object's view state.

(Inherited from DataPagerField)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

DataPagerField オブジェクトがそのビューステートの変更を追跡するようにします。これにより、変更をコントロールの ViewState プロパティに格納し、同じページに対する複数の要求の間で保持できるようになります。Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataPagerField)

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

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

以前に保存したビューステート情報を復元します。Restores view-state information that was saved previously.

(Inherited from DataPagerField)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

DataPagerField オブジェクトのビューステートに加えられた変更を保存します。Saves the changes that were made to the DataPagerField object's view state.

(Inherited from DataPagerField)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

DataPagerField オブジェクトがそのビューステートの変更を追跡するようにします。これにより、変更をコントロールの ViewState プロパティに格納し、同じページに対する複数の要求の間で保持できるようになります。Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataPagerField)

適用対象

こちらもご覧ください