PagerSettingsとは何？わかりやすく解説 Weblio辞書

PagerSettings イベント

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

参照

PagerSettings クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

改ページ位置の自動修正をサポートするコントロール内のページングコントロールのプロパティを表します。このクラスは継承できません。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 PagerSettings
    Implements IStateManager

Visual Basic (使用法)

Dim instance As PagerSettings

public sealed class PagerSettings : IStateManager

C++

public ref class PagerSettings sealed : IStateManager

public final class PagerSettings implements
 IStateManager

JScript

public final class PagerSettings implements
 IStateManager

解説

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

ページャは、さまざまな表示モードをサポートします。ページャを表示するモードを指定するには、Mode プロパティを設定します。各モードを次の表に示します。

モード	説明
NextPrevious	前のページへ移動するボタンと次のページへ移動するボタン。
NextPreviousFirstLast	前のページへ移動するボタン、次のページへ移動するボタン、最初のページへ移動するボタン、最後のページへ移動するボタン。
Numeric	ページに直接アクセスするための番号付きリンクボタン。
NumericFirstLast	番号付きリンクボタン、最初のリンクボタン、最後のリンクボタン。

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

プロパティ	説明
FirstPageText	最初のページへ移動するボタンのテキスト。
PreviousPageText	前のページへ移動するボタンのテキスト。
NextPageText	次のページへ移動するボタンのテキスト。
LastPageText	最後のページへ移動するボタンのテキスト。

次の表に示すプロパティを設定して、数値以外のボタンのイメージを表示することもできます。

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

メモ
イメージプロパティが設定されている場合、対応するテキストプロパティはイメージの代替テキストとして動作します。たとえば、FirstPageImageUrl プロパティが設定されている場合、FirstPageText プロパティによって指定されるテキストは、イメージの代替テキストとして表示されます。ツールヒントをサポートしているブラウザの場合、このテキストは対応するボタンのツールヒントとしても表示されます。

メモ

イメージプロパティが設定されている場合、対応するテキストプロパティはイメージの代替テキストとして動作します。たとえば、FirstPageImageUrl プロパティが設定されている場合、FirstPageText プロパティによって指定されるテキストは、イメージの代替テキストとして表示されます。ツールヒントをサポートしているブラウザの場合、このテキストは対応するボタンのツールヒントとしても表示されます。

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

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

使用例

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

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form 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="C#" %>

<html>
  <body>
    <form 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>

継承階層

System.Object
System.Web.UI.WebControls.PagerSettings

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PagerSettings メンバ
System.Web.UI.WebControls 名前空間
DetailsView クラス
DetailsView.AllowPaging プロパティ
DetailsView.PagerSettings プロパティ
FormView クラス
FormView.AllowPaging プロパティ
FormView.PagerSettings プロパティ
GridView クラス
GridView.AllowPaging プロパティ
GridView.PagerSettings プロパティ
Mode
FirstPageText
FirstPageImageUrl
PreviousPageText
PreviousPageImageUrl
NextPageText
LastPageText
LastPageImageUrl
PageButtonCount
Position
Visible

PagerSettings コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New PagerSettings

public PagerSettings ()

C++

public:
PagerSettings ()

public PagerSettings ()

JScript

public function PagerSettings ()

解説

PagerSettings コンストラクタを使用して、PagerSettings クラスの新しいインスタンスを作成します。

メモ
通常、PagerSettings コンストラクタは、カスタムコントロールでページングサポートを提供するときにコントロール開発者が使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PagerSettings クラス
PagerSettings メンバ
System.Web.UI.WebControls 名前空間
DetailsView クラス
DetailsView.AllowPaging プロパティ
DetailsView.PagerSettings プロパティ
FormView クラス
FormView.AllowPaging プロパティ
FormView.PagerSettings プロパティ
GridView クラス
GridView.AllowPaging プロパティ
GridView.PagerSettings プロパティ

PagerSettings プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	FirstPageImageUrl	最初のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	FirstPageText	最初のページへ移動するボタンに表示するテキストを取得または設定します。
	LastPageImageUrl	最後のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	LastPageText	最後のページへ移動するボタンに表示するテキストを取得または設定します。
	Mode	改ページ位置の自動修正をサポートするコントロールで、ページャコントロールを表示するモードを取得または設定します。
	NextPageImageUrl	次のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	NextPageText	次のページへ移動するボタンに表示するテキストを取得または設定します。
	PageButtonCount	Mode プロパティが Numeric 値または NumericFirstLast 値に設定されている場合に、ページャに表示されるページボタンの数を取得または設定します。
	Position	ページャが表示される位置を指定する値を取得または設定します。
	PreviousPageImageUrl	前のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	PreviousPageText	前のページへ移動するボタンに表示するテキストを取得または設定します。
	Visible	改ページの自動修正をサポートするコントロールにページングコントロールが表示されるかどうかを示す値を取得または設定します。

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

	名前	説明
	System.Web.UI.IStateManager.IsTrackingViewState	このメンバの説明については、IsTrackingViewState のトピックを参照してください。

参照

PagerSettings メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。 PagerSettings オブジェクトの文字列形式を取得します。

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

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

	名前	説明
	System.Web.UI.IStateManager.LoadViewState	以前に保存した PagerSettings オブジェクトのビューステートを読み込みます。
	System.Web.UI.IStateManager.SaveViewState	PagerSettings オブジェクトの現在のビューステートを保存します。
	System.Web.UI.IStateManager.TrackViewState	PagerSettings オブジェクトに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。

参照

PagerSettings メンバ

改ページ位置の自動修正をサポートするコントロール内のページングコントロールのプロパティを表します。このクラスは継承できません。

PagerSettings データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

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

パブリックプロパティ

	名前	説明
	FirstPageImageUrl	最初のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	FirstPageText	最初のページへ移動するボタンに表示するテキストを取得または設定します。
	LastPageImageUrl	最後のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	LastPageText	最後のページへ移動するボタンに表示するテキストを取得または設定します。
	Mode	改ページ位置の自動修正をサポートするコントロールで、ページャコントロールを表示するモードを取得または設定します。
	NextPageImageUrl	次のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	NextPageText	次のページへ移動するボタンに表示するテキストを取得または設定します。
	PageButtonCount	Mode プロパティが Numeric 値または NumericFirstLast 値に設定されている場合に、ページャに表示されるページボタンの数を取得または設定します。
	Position	ページャが表示される位置を指定する値を取得または設定します。
	PreviousPageImageUrl	前のページへ移動するボタン用に表示するイメージの URL を取得または設定します。
	PreviousPageText	前のページへ移動するボタンに表示するテキストを取得または設定します。
	Visible	改ページの自動修正をサポートするコントロールにページングコントロールが表示されるかどうかを示す値を取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。 PagerSettings オブジェクトの文字列形式を取得します。

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリックイベント

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

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

	名前	説明
	System.Web.UI.IStateManager.LoadViewState	以前に保存した PagerSettings オブジェクトのビューステートを読み込みます。
	System.Web.UI.IStateManager.SaveViewState	PagerSettings オブジェクトの現在のビューステートを保存します。
	System.Web.UI.IStateManager.TrackViewState	PagerSettings オブジェクトに対するビューステートの変更の追跡と保存を始める開始点にマークを付けます。
	System.Web.UI.IStateManager.IsTrackingViewState	このメンバの説明については、IsTrackingViewState のトピックを参照してください。

参照

PagerSettingsとは？わかりやすく解説

PagerSettings イベント

関連項目

PagerSettings クラス

PagerSettings コンストラクタ

PagerSettings プロパティ

関連項目

PagerSettings メソッド

関連項目

PagerSettings メンバ

関連項目

「PagerSettings」の関連用語


	© 2024 Microsoft.All rights reserved.

PagerSettingsとは？ わかりやすく解説

PagerSettings イベント

関連項目

PagerSettings クラス

PagerSettings コンストラクタ

PagerSettings プロパティ

関連項目

PagerSettings メソッド

関連項目

PagerSettings メンバ

関連項目

急上昇のことば

「PagerSettings」の関連用語

PagerSettingsとは？わかりやすく解説