PagerSettings クラス

定義

改ページ調整をサポートするコントロールのページング コントロールのプロパティを表します。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
継承
PagerSettings
属性
実装

次のコード例は、 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.

プロパティがNextPrevious NumericFirstLast 、 、NextPreviousFirstLastのいずれかの値に設定されている場合、数値以外のボタンのテキストをカスタマイズするには、次の表に示すプロパティを設定します。 ModeWhen 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.

注意

Image プロパティが設定されている場合、対応する text プロパティはイメージの代替テキストとして機能します。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.

プロパティがまたはNumeric NumericFirstLastの値に設定されている場合は、 PageButtonCountプロパティを設定することによって、ページャーに表示するページボタンの数を指定できます。 ModeWhen 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 クラスの新しいインスタンスを初期化します。Initializes a new instance of the PagerSettings class.

プロパティ

FirstPageImageUrl

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

FirstPageText

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

LastPageImageUrl

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

LastPageText

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

Mode

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

NextPageImageUrl

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

NextPageText

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

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

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

PreviousPageImageUrl

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

PreviousPageText

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

Visible

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

メソッド

Equals(Object)

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

(継承元 Object)
GetHashCode()

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

(継承元 Object)
GetType()

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

(継承元 Object)
MemberwiseClone()

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

(継承元 Object)
ToString()

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

イベント

PropertyChanged

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

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

IStateManager.IsTrackingViewState

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

IStateManager.LoadViewState(Object)

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

IStateManager.SaveViewState()

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

IStateManager.TrackViewState()

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

適用対象

こちらもご覧ください