GridView.PagerSettings Eigenschaft

Definition

Ruft einen Verweis auf das PagerSettings-Objekt ab, mit dem Sie die Eigenschaften der Pagerschaltflächen in einem GridView-Steuerelement festlegen können.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

Eigenschaftswert

Ein Verweis auf das PagerSettings, mit dem Sie die Eigenschaften der Pagerschaltflächen in einem GridView-Steuerelement festlegen können.A reference to the PagerSettings that enables you to set the properties of the pager buttons in a GridView control.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die PagerSettings -Eigenschaft deklarativ festgelegt wird.The following example demonstrates how to set the PagerSettings property declaratively. Die Schriftart und der Hintergrund der Pager-Zeile werden auf blau bzw. Hellblau festgelegt.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>

Hinweise

Verwenden Sie PagerSettings die-Eigenschaft, um die Einstellungen der Pager-Zeile GridView in einem-Steuerelement zu steuern.Use the PagerSettings property to control the settings of the pager row in a GridView control. Die Zeile Pager wird angezeigt, wenn das Pagingfeature aktiviert ist (indem die AllowPaging -Eigenschaft trueauf festgelegt wird) und enthält die Steuerelemente, die dem Benutzer ermöglichen, zu den verschiedenen Seiten im-Steuerelement zu navigieren.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. Diese Eigenschaft ist schreibgeschützt. Sie können jedoch die Eigenschaften des PagerSettings zurückgegebenen Objekts festlegen.This property is read-only; however, you can set the properties of the PagerSettings object it returns. Die Eigenschaften können mithilfe einer der folgenden Methoden deklarativ festgelegt werden:The properties can be set declaratively using one of the following methods:

  • Platzieren Sie ein Attribut im öffnenden Tag des GridView -Steuer Elements im Property-SubpropertyFormular, Subproperty wobei eine PagerSettings-ModeEigenschaft des PagerSettings -Objekts ist (z. b.).Place 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).

  • Schachteln Sie <PagerSettings> ein-Element zwischen dem öffnenden und dem GridView schließenden Tag des-Steuer Elements.Nest a <PagerSettings> element between the opening and closing tags of the GridView control.

Die Eigenschaften können auch Programm gesteuert im Formular Property.Subproperty ( PagerStyle.Modez. b.) festgelegt werden.The properties can also be set programmatically in the form Property.Subproperty (for example, PagerStyle.Mode). Zu den allgemeinen Einstellungen gehören in der Regel der Anzeigemodus der Pager-Zeile und benutzerdefinierter Text bzw. Bilder für die Navigations Steuerelemente.Common settings usually include the pager row's display mode and custom text or images for the navigation controls.

Gilt für:

Siehe auch