次の方法で共有


PagerSettings クラス

定義

改ページ調整をサポートするコントロールのページング コントロールのプロパティを表します。 このクラスは継承できません。

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

次のコード例では、 プロパティに含まれる PagerSettings オブジェクトをPagerSettings使用して、コントロールのポケットベル行に表示されるボタンのテキストをカスタマイズする方法をGridView示します。


<%@ 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>

注釈

改ページをサポートするコントロール (、DetailsView、および FormView コントロールなどGridView) では、ユーザーがコントロール内のページを移動できるようにする、ページャーと呼ばれるコントロールのセットを表示できます。 クラスは PagerSettings 、ページャーのプロパティを表すために、これらのコントロールによって使用されます。 一般に PagerSettings 、 オブジェクトは コントロールの プロパティに PagerSettings 格納されます。 オブジェクトのプロパティを設定することで、ポケットベルを PagerSettings カスタマイズできます。

ポケットベルは、いくつかの異なる表示モードをサポートしています。 ポケットベルを表示するモードを指定するには、 プロパティを設定します Mode 。 次の表では、さまざまなモードについて説明します。

モード 説明
NextPrevious [前のページ] ボタンと [次ページ] ボタン。
NextPreviousFirstLast [前ページ]、[次ページ]、[最初のページ]、[最後のページ] の各ボタン。
Numeric ページに直接アクセスするための番号付きリンク ボタン。
NumericFirstLast Numbered-link、first-link、last-link の各ボタン。

プロパティが Mode 、、NextPreviousFirstLastまたは NumericFirstLast の値にNextPrevious設定されている場合は、次の表に示すプロパティを設定することで、数値以外のボタンのテキストをカスタマイズできます。

プロパティ 説明
FirstPageText 先頭ページ ボタンのテキスト。
PreviousPageText 前のページ ボタンのテキスト。
NextPageText [次のページ] ボタンのテキスト。
LastPageText 最後のページ ボタンのテキスト。

別の方法として、次の表に示すようにプロパティを設定することで、数値以外のボタンの画像を表示することもできます。

プロパティ 説明
FirstPageImageUrl 最初のページへ移動するボタン用に表示するイメージの URL。
PreviousPageImageUrl 前のページへ移動するボタン用に表示するイメージの URL。
NextPageImageUrl 次のページへ移動するボタン用に表示するイメージの URL。
LastPageImageUrl 最後のページへ移動するボタン用に表示するイメージの URL。

Note

image プロパティを設定すると、対応する text プロパティがイメージの代替テキストとして機能します。 たとえば、 プロパティを FirstPageImageUrl 設定すると、 プロパティで FirstPageText 指定されたテキストが画像の代替テキストとして表示されます。 ツールヒントをサポートするブラウザーでは、このテキストは対応するボタンのツールヒントとしても表示されます。

プロパティが Mode または NumericFirstLast 値にNumeric設定されている場合は、 プロパティを設定することで、ポケットベルに表示するページ ボタンの数をPageButtonCount指定できます。

ポケットベルは、コントロールの上部、下部、または上下の両方に表示できます。 ポケットベルの位置を指定するには、 プロパティを設定します Position 。 ポケットベルを表示または非表示にするには、 プロパティを使用します Visible

コンストラクター

PagerSettings()

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

プロパティ

FirstPageImageUrl

最初のページへ移動するボタン用に表示するイメージの URL を取得または設定します。

FirstPageText

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

LastPageImageUrl

最後のページへ移動するボタン用に表示するイメージの URL を取得または設定します。

LastPageText

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

Mode

改ページ位置の自動修正をサポートするコントロールで、ページャー コントロールを表示するモードを取得または設定します。

NextPageImageUrl

次のページへ移動するボタン用に表示するイメージの URL を取得または設定します。

NextPageText

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

PageButtonCount

Mode プロパティが Numeric 値または NumericFirstLast 値に設定されている場合に、ページャーに表示されるページ ボタンの数を取得または設定します。

Position

ページャーが表示される位置を指定する値を取得または設定します。

PreviousPageImageUrl

前のページへ移動するボタン用に表示するイメージの URL を取得または設定します。

PreviousPageText

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

Visible

改ページの自動修正をサポートするコントロールにページング コントロールが表示されるかどうかを示す値を取得または設定します。

メソッド

Equals(Object)

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

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

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

(継承元 Object)
MemberwiseClone()

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

(継承元 Object)
ToString()

PagerSettings オブジェクトの文字列形式を取得します。

イベント

PropertyChanged

PagerSettings オブジェクトのプロパティが値を変更するときに発生します。

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

IStateManager.IsTrackingViewState

サーバー コントロールがビューステートの変更を追跡しているかどうかを示す値を取得します。

IStateManager.LoadViewState(Object)

以前に保存した PagerSettings オブジェクトのビューステートを読み込みます。

IStateManager.SaveViewState()

PagerSettings オブジェクトの現在のビューステートを保存します。

IStateManager.TrackViewState()

PagerSettings オブジェクトに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。

適用対象

こちらもご覧ください