PagerSettings PagerSettings PagerSettings PagerSettings Class

定義

改ページ調整をサポートするコントロールのページング コントロールのプロパティを表します。Represents the properties of the paging controls in a control that supports pagination. このクラスは継承できません。This class cannot be inherited.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
継承
PagerSettingsPagerSettingsPagerSettingsPagerSettings
属性
実装

次のコード例は、使用する方法を示します、PagerSettingsオブジェクトに含まれている、 PagerSettings 、ページャーに表示されるボタンのテキストをカスタマイズするプロパティをGridViewコントロール。The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a GridView 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

注釈

改ページ調整をサポートするコントロール (など、 GridViewDetailsView、およびFormViewコントロール) と呼ばれるコントロールのセットを表示できるページャーユーザー コントロール内でページ間を移動できるようにします。Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. PagerSettingsクラスを使用してこれらのコントロールをページャーのプロパティを表します。The PagerSettings class is used by these controls to represent the properties of the pager. 一般に、PagerSettingsにオブジェクトが格納されている、PagerSettingsコントロールのプロパティ。In general, the PagerSettings object is stored in the PagerSettings property of the control. プロパティを設定して、ポケットベルをカスタマイズすることができます、PagerSettingsオブジェクト。You can customize the pager by setting the properties of the PagerSettings object.

ポケットベルには、いくつかの異なる表示モードがサポートされています。The pager supports several different display modes. ページャーを表示するためのモードを指定するには、設定、Modeプロパティ。To specify the mode in which to display the pager, set the Mode property. 次の表では、さまざまなモードについて説明します。The following table describes the different modes.

モードMode 説明Description
NextPrevious 前のページに移動し、次のページのボタン。Previous-page and next-page buttons.
NextPreviousFirstLast 前のページで、次のページ、最初のページ、および最後のページ ボタン。Previous-page, next-page, first-page, and last -page buttons.
Numeric 直接ページにアクセスするリンク ボタン番号が付けられます。Numbered link buttons to access pages directly.
NumericFirstLast 番号付きリンク、最初のリンク、および最後のリンク ボタンNumbered-link, first-link, and last-link buttons.

ときに、Modeプロパティに設定されて、 NextPreviousNextPreviousFirstLast、またはNumericFirstLast値が数値以外のボタンのテキストをカスタマイズするには、次の表に示したプロパティを設定します。When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table.

プロパティProperty 説明Description
FirstPageText 最初のページ ボタンのテキスト。Text for the first-page button.
PreviousPageText 前のページ ボタンのテキスト。Text for the previous-page button.
NextPageText 次のページ ボタンのテキスト。Text for the next-page button.
LastPageText 最後のページ ボタンのテキスト。Text for the last-page button.

代わりに、次の表に示すようにプロパティを設定して数値以外のボタンのイメージを表示することもできます。As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table.

プロパティProperty 説明Description
FirstPageImageUrl 最初のページへ移動するボタン用に表示するイメージの URL。The URL to an image to display for the first-page button.
PreviousPageImageUrl 前のページへ移動するボタン用に表示するイメージの URL。The URL to an image to display for the previous-page button.
NextPageImageUrl 次のページへ移動するボタン用に表示するイメージの URL。The URL to an image to display for the next-page button.
LastPageImageUrl 最後のページへ移動するボタン用に表示するイメージの URL。The URL to an image to display for the last-page button.

注意

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

ときに、Modeプロパティに設定されて、NumericまたはNumericFirstLast値を設定してページャーに表示するページのボタンの数を指定できます、PageButtonCountプロパティ。When the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property.

上部、下部、または両方の上部と下部コントロールのページャーを表示できます。The pager can be displayed at the top, the bottom, or both the top and bottom of a control. ページャーの位置を指定するには、設定、Positionプロパティ。To specify the position of the pager, set the Position property. または、ポケットベルを非表示に使用して、Visibleプロパティ。To show or hide the pager, use the Visible property.

コンストラクター

PagerSettings() PagerSettings() PagerSettings() PagerSettings()

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

プロパティ

FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl

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

FirstPageText FirstPageText FirstPageText FirstPageText

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

LastPageImageUrl LastPageImageUrl LastPageImageUrl LastPageImageUrl

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

LastPageText LastPageText LastPageText LastPageText

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

Mode Mode Mode Mode

改ページ位置の自動修正をサポートするコントロールで、ページャー コントロールを表示するモードを取得または設定します。Gets or sets the mode in which to display the pager controls in a control that supports pagination.

NextPageImageUrl NextPageImageUrl NextPageImageUrl NextPageImageUrl

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

NextPageText NextPageText NextPageText NextPageText

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

PageButtonCount PageButtonCount PageButtonCount PageButtonCount

Mode プロパティが Numeric 値または NumericFirstLast 値に設定されている場合に、ページャーに表示されるページ ボタンの数を取得または設定します。Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.

Position Position Position Position

ページャーが表示される位置を指定する値を取得または設定します。Gets or sets a value that specifies the location where the pager is displayed.

PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl

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

PreviousPageText PreviousPageText PreviousPageText PreviousPageText

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

Visible Visible Visible Visible

改ページの自動修正をサポートするコントロールにページング コントロールが表示されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

メソッド

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

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

PagerSettings オブジェクトの文字列形式を取得します。Retrieves the string representation of a PagerSettings object.

イベント

PropertyChanged PropertyChanged PropertyChanged PropertyChanged

PagerSettings オブジェクトのプロパティが値を変更するときに発生します。Occurs when a property of a PagerSettings object changes values.

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

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

サーバー コントロールがビューステートの変更を追跡しているかどうかを示す値を取得します。Gets a value that indicates whether the server control is tracking its view state changes.

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

以前に保存した PagerSettings オブジェクトのビューステートを読み込みます。Loads the previously saved view state of the PagerSettings object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

PagerSettings オブジェクトの現在のビューステートを保存します。Saves the current view state of the PagerSettings object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

PagerSettings オブジェクトに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。Marks the starting point at which to begin tracking and saving view state changes to the PagerSettings object.

適用対象

こちらもご覧ください