Freigeben über

PagerSettings.Mode Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen des Modus, in dem die Pagersteuerelemente in einem Steuerelement angezeigt werden, das die Paginierung unterstützt.

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 lautet PagerButtons.Numeric.

Ausnahmen

ArgumentOutOfRangeException

Der Mode Wert wird auf einen Wert festgelegt, der nicht einer der PagerButtons Werte ist.

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 Paginierung unterstützen, bieten mehrere Modi, in denen die Paging-Steuerelemente angezeigt werden. Verwenden Sie die Mode Eigenschaft, um den Modus anzugeben. In der folgenden Tabelle werden die verschiedenen Modi für Paginierungssteuerelemente beschrieben.

Modus Beschreibung
NextPrevious Schaltflächen "Vorherige Seite" und "Nächste Seite".
NextPreviousFirstLast Schaltflächen "Vorherige Seite", "Nächste Seite", "Erste Seite" und "Letzte Seite".
Numeric Schaltflächen für nummerierte Links, um direkt auf Seiten zuzugreifen.
NumericFirstLast Schaltflächen "Nummeriert" und "Erster Link" und "Letzter 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 gezeigten Eigenschaften festlegen.

Eigentum 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 gezeigten Eigenschaften festlegen.

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

Hinweis

Wenn eine Bildeigenschaft festgelegt wird, fungiert die entsprechende Texteigenschaft als alternativer Text für das Bild. Wenn beispielsweise die FirstPageImageUrl Eigenschaft festgelegt wird, wird der durch die FirstPageText Eigenschaft angegebene Text als Alternativtext 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:

Weitere Informationen