PagerSettings.Position プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PagerSettings.Position プロパティ

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

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

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

Visual Basic (宣言)

Public Property Position As
 PagerPosition

Visual Basic (使用法)

Dim instance As PagerSettings
Dim value As PagerPosition

value = instance.Position

instance.Position = value

public PagerPosition Position { get; set;
 }

C++

public:
property PagerPosition Position {
    PagerPosition get ();
    void set (PagerPosition value);
}

/** @property */
public PagerPosition get_Position ()

/** @property */
public void set_Position (PagerPosition value)

JScript

public function get Position
 () : PagerPosition

public function set Position
 (value : PagerPosition)

プロパティ値
PagerPosition 値の 1 つ。既定値は Bottom です。

例外

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

解説

Position プロパティを使用して、ページャが表示される位置を指定します。各位置を次の表に示します。

位置	場所
Bottom	コントロールの下部。
Top	コントロールの上部。
TopAndBottom	コントロールの上部と下部の両方。

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

使用例

Position プロパティを使用して、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>