PagerSettings.Mode Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 NextPreviousFirstLast NumericFirstLast 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

Freigeben über