PagerSettings.Mode プロパティ

.NET Framework クラス ライブラリ リファレンス

PagerSettings.Mode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Property Mode As
 PagerButtons

Visual Basic (使用法)

Dim instance As PagerSettings
Dim value As PagerButtons

value = instance.Mode

instance.Mode = value

C#

public PagerButtons Mode { get; set;
 }

C++

public:
property PagerButtons Mode {
    PagerButtons get ();
    void set (PagerButtons value);
}

J#

/** @property */
public PagerButtons get_Mode ()

/** @property */
public void set_Mode (PagerButtons value)

JScript

public function get Mode
 () : PagerButtons

public function set Mode
 (value : PagerButtons)

プロパティ値
PagerButtons 値の 1 つ。既定値は PagerButtons.Numeric です。

例外

例外の種類	条件
ArgumentOutOfRangeException	Mode が、PagerButtons 値の 1 つではない値に設定されています。

解説

改ページ位置の自動修正をサポートするコントロールには、ページング コントロールを表示する複数のモードが用意されています。モードを指定するには、Mode プロパティを使用します。ページ編集コントロールの各モードを次の表に示します。

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

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

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

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

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

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

このプロパティの値はビューステートに格納されます。

使用例

Mode プロパティを使用して、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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

C#

<%@ 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="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

プラットフォーム

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 クラス
PagerSettings メンバ
System.Web.UI.WebControls 名前空間
PagerButtons 列挙体
PagerSettings.FirstPageImageUrl プロパティ
PagerSettings.FirstPageText プロパティ
PagerSettings.LastPageImageUrl プロパティ
PagerSettings.LastPageText プロパティ
NextPageImageUrl
NextPageText
PreviousPageImageUrl
PreviousPageText