Share via

PagerSettings.Mode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia tryb wyświetlania kontrolek pager w kontrolce obsługującej stronicowanie.

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

Wartość właściwości

PagerButtons

PagerButtons Jedna z wartości. Wartość domyślna to PagerButtons.Numeric.

Wyjątki

ArgumentOutOfRangeException

Właściwość Mode jest ustawiona na wartość, która nie jest jedną z PagerButtons wartości.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą Mode właściwości określić, że wiersz pagera dla GridView kontrolki powinien wyświetlać przyciski liczbowe.


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

Uwagi

Kontrolki obsługujące stronicowanie zapewniają wiele trybów wyświetlania kontrolek stronicowania. Użyj właściwości , Mode aby określić tryb. W poniższej tabeli opisano różne tryby kontrolek stronicowania.

Tryb Opis
NextPrevious Przyciski poprzedniej strony i następnej strony.
NextPreviousFirstLast Przyciski poprzedniej strony, następnej strony, pierwszej strony i ostatniej strony.
Numeric Przyciski linków numerowanych w celu uzyskiwania bezpośredniego dostępu do stron.
NumericFirstLast Numerowane i przyciski pierwszego linku i ostatniego linku.

Mode Gdy właściwość jest ustawiona na NextPreviouswartość , NextPreviousFirstLastlub NumericFirstLast , możesz określić niestandardowy tekst dla przycisków nieliczbowych, ustawiając właściwości pokazane w poniższej tabeli.

Właściwość Opis
FirstPageText Tekst przycisku pierwszej strony.
PreviousPageText Tekst przycisku poprzedniej strony.
NextPageText Tekst przycisku następnej strony.
LastPageText Tekst przycisku ostatniej strony.

Alternatywnie można również wyświetlić obrazy dla przycisków nieliczbowych, ustawiając właściwości pokazane w poniższej tabeli.

Właściwość Opis
FirstPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku pierwszej strony.
PreviousPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku poprzedniej strony.
NextPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku następnej strony.
LastPageImageUrl Adres URL obrazu do wyświetlenia dla ostatniego przycisku strony.

Uwaga

Po ustawieniu właściwości obrazu odpowiednia właściwość tekstowa działa jako tekst alternatywny obrazu. Na przykład po ustawieniu FirstPageImageUrl właściwości tekst określony przez FirstPageText właściwość jest wyświetlany jako tekst alternatywny obrazu. W przeglądarkach obsługujących etykietki narzędzi ten tekst jest również wyświetlany jako etykietka narzędzia dla odpowiedniego przycisku.

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też