PagerSettings クラス

リファレンス

定義

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

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

重要

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

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

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

継承: Object
PagerSettings

属性: TypeConverterAttribute

実装: IStateManager

例

次のコード例では、プロパティに含まれる 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 オブジェクトに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。

適用対象