PagerSettings.Mode Eigenschaft

  • Referenz

Definition

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

Ruft den Modus ab, in dem die Pagersteuerelemente in einem Steuerelement angezeigt werden, das Paginierung unterstützt, oder legt diesen Modus fest.

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

Eigenschaftswert

PagerButtons

Einer der PagerButtons-Werte. Der Standardwert ist PagerButtons.Numeric.

Ausnahmen

ArgumentOutOfRangeException

Mode wird auf einen Wert festgelegt, der mit keinem der PagerButtons-Werte übereinstimmt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Mode Eigenschaft verwendet wird, um anzugeben, dass die Pagerzeile für ein GridView Steuerelement numerische Schaltflächen anzeigen soll.


<%@ 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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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="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>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            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>

Hinweise

Steuerelemente, die die Pagination unterstützen, stellen mehrere Modi bereit, in denen die Pagingsteuerelemente angezeigt werden sollen. Verwenden Sie die Eigenschaft, um den Mode Modus anzugeben. In der folgenden Tabelle werden die verschiedenen Modi für Paginationssteuerelemente beschrieben.

Mode BESCHREIBUNG
NextPrevious Vorherige Seiten- und Next-Page-Schaltflächen.
NextPreviousFirstLast Vorherige Seiten- und Next-Page-, First-Page- und Last-Page-Schaltflächen.
Numeric Nummerierte Linkschaltflächen, um direkt auf Seiten zuzugreifen.
NumericFirstLast Nummerierte und schaltflächen "First-Link" und "Last-Link".

Wenn die Mode Eigenschaft auf den NextPreviousWert oder NextPreviousFirstLastNumericFirstLast den Wert festgelegt ist, können Sie benutzerdefinierten Text für die nicht numerischen Schaltflächen angeben, indem Sie die in der folgenden Tabelle angezeigten Eigenschaften festlegen.

Eigenschaft BESCHREIBUNG
FirstPageText Text für die Schaltfläche "Erste Seite".
PreviousPageText Text für die Schaltfläche "Vorherige Seite".
NextPageText Text für die Schaltfläche "Nächste Seite".
LastPageText Text für die Schaltfläche "Letzte Seite".

Alternativ können Sie auch Bilder für die nicht numerischen Schaltflächen anzeigen, indem Sie die in der folgenden Tabelle angezeigten Eigenschaften festlegen.

Eigenschaft BESCHREIBUNG
FirstPageImageUrl Die URL zu einem Bild, das für die Erste Seite-Schaltfläche angezeigt werden soll.
PreviousPageImageUrl Die URL zu einem Bild, das für die Vorherige Seite-Schaltfläche angezeigt werden soll.
NextPageImageUrl Die URL zu einem Bild, das für die Nächste Seite-Schaltfläche angezeigt werden soll.
LastPageImageUrl Die URL zu einem Bild, das für die Letzte Seite-Schaltfläche angezeigt werden soll.

Hinweis

Wenn eine Bildeigenschaft festgelegt wird, fungiert die entsprechende Texteigenschaft als alternativer Text für das Bild. Wenn die FirstPageImageUrl Eigenschaft beispielsweise festgelegt wird, wird der durch die FirstPageText Eigenschaft angegebene Text als alternativer Text für das Bild angezeigt. In Browsern, die QuickInfos unterstützen, wird dieser Text auch als QuickInfo für die entsprechende Schaltfläche angezeigt.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch