Freigeben über

GridView.PagerSettings Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft einen Verweis auf das PagerSettings Objekt ab, mit dem Sie die Eigenschaften der Pagerschaltflächen in einem GridView Steuerelement festlegen können.

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; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.PagerSettings : System.Web.UI.WebControls.PagerSettings
Public Overridable ReadOnly Property PagerSettings As PagerSettings

Eigenschaftswert

PagerSettings

Ein Verweis auf die, mit dem PagerSettings Sie die Eigenschaften der Pagerschaltflächen in einem GridView Steuerelement festlegen können.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die PagerSettings Eigenschaft deklarativ festgelegt wird. Sie legt die Schriftart bzw. den Hintergrund für die Pagerzeile auf Blau und Hellblau fest.


<%@ 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>

Hinweise

Verwenden Sie die PagerSettings Eigenschaft, um die Einstellungen der Pagerzeile in einem GridView Steuerelement zu steuern. Die Pagerzeile wird angezeigt, wenn das Paging-Feature aktiviert ist (durch Festlegen der AllowPaging Eigenschaft auf true) und enthält die Steuerelemente, mit denen der Benutzer zu den verschiedenen Seiten im Steuerelement navigieren kann. Diese Eigenschaft ist schreibgeschützt; Sie können jedoch die Eigenschaften des PagerSettings zurückgegebenen Objekts festlegen. Die Eigenschaften können deklarativ mit einer der folgenden Methoden festgelegt werden:

  • Platzieren Sie ein Attribut im öffnenden Tag des GridView Steuerelements im Formular Property-Subproperty, wobei Subproperty es sich um eine Eigenschaft des PagerSettings Objekts handelt (z. B PagerSettings-Mode. ).

  • Schachteln eines <PagerSettings> Elements zwischen den öffnenden und schließenden Tags des GridView Steuerelements.

Die Eigenschaften können auch programmgesteuert im Formular Property.Subproperty festgelegt werden (z. B PagerStyle.Mode. ). Allgemeine Einstellungen enthalten in der Regel den Anzeigemodus der Pagerzeile und benutzerdefinierten Text oder Bilder für die Navigationssteuerelemente.

Gilt für:

Weitere Informationen