PagerSettings.Mode Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger i vilket läge du vill visa pager-kontrollerna i en kontroll som stöder sidnumrering.

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

Egenskapsvärde

PagerButtons

Ett av PagerButtons värdena. Standardvärdet är PagerButtons.Numeric.

Undantag

ArgumentOutOfRangeException

Mode är inställt på ett värde som inte är ett av PagerButtons värdena.

Exempel

I följande kodexempel visas hur du använder Mode egenskapen för att ange att pager-raden för en GridView kontroll ska visa numeriska knappar.


<%@ 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>

Kommentarer

Kontroller som stöder sidnumrering ger flera lägen där växlingskontrollerna ska visas. Använd egenskapen Mode för att ange läget. I följande tabell beskrivs de olika lägena för sidnumreringskontroller.

Mode Description
NextPrevious Knappar för föregående sida och nästa sida.
NextPreviousFirstLast Knappar på föregående sida, nästa sida, första sidan och sista sidan.
Numeric Numrerade länkknappar för att komma åt sidor direkt.
NumericFirstLast Numrerade knappar och knappar för första och sista länken.

När egenskapen Mode är inställd på NextPreviousvärdet , NextPreviousFirstLasteller NumericFirstLast kan du ange anpassad text för de icke-numeriska knapparna genom att ange egenskaperna som visas i följande tabell.

Property Description
FirstPageText Text för knappen för första sidan.
PreviousPageText Text för knappen föregående sida.
NextPageText Text för knappen nästa sida.
LastPageText Text för knappen för sista sidan.

Du kan också visa bilder för icke-numeriska knappar genom att ange de egenskaper som visas i följande tabell.

Property Description
FirstPageImageUrl URL:en till en bild som ska visas för knappen på första sidan.
PreviousPageImageUrl URL:en till en bild som ska visas för knappen föregående sida.
NextPageImageUrl URL:en till en bild som ska visas för knappen nästa sida.
LastPageImageUrl URL:en till en bild som ska visas för knappen på sista sidan.

Note

När en bildegenskap har angetts fungerar motsvarande textegenskap som alternativ text för bilden. När egenskapen FirstPageImageUrl till exempel har angetts visas texten som anges av FirstPageText egenskapen som alternativ text för bilden. I webbläsare som stöder Knappbeskrivningar visas även den här texten som en knappbeskrivning för motsvarande knapp.

Värdet för den här egenskapen lagras i visningstillstånd.

Gäller för

Se även