GridView.PagerSettings Eigenschaft

  • Referenz

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 das PagerSettings, mit dem 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 und 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 Seitenblattfeature aktiviert ist (indem Sie die Eigenschaft trueauf ) festlegen AllowPaging und die Steuerelemente enthalten, 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 mithilfe einer der folgenden Methoden festgelegt werden:

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

  • Verschachteln Sie ein <PagerSettings> Element zwischen den öffnenden und schließenden Tags des GridView Steuerelements.

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

Gilt für

Siehe auch