GridView.PagerSettings プロパティ

定義

PagerSettings コントロールのページャー ボタンのプロパティを設定できるようにする GridView オブジェクトへの参照を取得します。Gets a reference to the PagerSettings object that enables you to set the properties of the pager buttons in a GridView control.

public:
 virtual property System::Web::UI::WebControls::PagerSettings ^ PagerSettings { System::Web::UI::WebControls::PagerSettings ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.PagerSettings PagerSettings { get; }
member this.PagerSettings : System.Web.UI.WebControls.PagerSettings
Public Overridable ReadOnly Property PagerSettings As PagerSettings

プロパティ値

PagerSettings コントロールのページャー ボタンのプロパティを設定できるようにする GridView オブジェクトへの参照。A reference to the PagerSettings that enables you to set the properties of the pager buttons in a GridView control.

属性

次の例は、プロパティを宣言PagerSettingsによって設定する方法を示しています。The following example demonstrates how to set the PagerSettings property declaratively. ここでは、ページャー行のフォントと背景をそれぞれ blue と薄い blue に設定します。It sets the font and background for the pager row to blue and light blue, respectively.


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

注釈

コントロールのページ行の設定を制御するには、 PagerSettingsプロパティを使用します。 GridViewUse the PagerSettings property to control the settings of the pager row in a GridView control. ページング機能が有効になっている場合 ( AllowPagingプロパティをに設定するtrueことにより)、ページャー行が表示されます。また、ユーザーがコントロール内のさまざまなページに移動できるようにするコントロールが含まれています。The pager row is displayed when the paging feature is enabled (by setting the AllowPaging property to true) and contains the controls that allow the user to navigate to the different pages in the control. このプロパティは読み取り専用です。ただし、返されるPagerSettingsオブジェクトのプロパティを設定することはできます。This property is read-only; however, you can set the properties of the PagerSettings object it returns. プロパティは、次のいずれかの方法を使用して、宣言によって設定できます。The properties can be set declaratively using one of the following methods:

  • フォームGridView Subproperty PagerSettings PagerSettings-Mode内のコントロールの開始タグに属性を配置します。ここで、はオブジェクトのプロパティ (など) です。 Property-SubpropertyPlace an attribute in the opening tag of the GridView control in the form Property-Subproperty, where Subproperty is a property of the PagerSettings object (for example, PagerSettings-Mode).

  • コントロールの開始タグと終了タグの間に要素を入れ子に<PagerSettings>します。 GridViewNest a <PagerSettings> element between the opening and closing tags of the GridView control.

プロパティは、フォームProperty.Subpropertyでプログラムを使用して設定することもできます (たとえば、 PagerStyle.Mode)。The properties can also be set programmatically in the form Property.Subproperty (for example, PagerStyle.Mode). 一般的な設定には、通常、ページャー行の表示モードと、ナビゲーションコントロール用のカスタムテキストまたはイメージが含まれます。Common settings usually include the pager row's display mode and custom text or images for the navigation controls.

適用対象

こちらもご覧ください