Sdílet prostřednictvím

PagerSettings.Mode Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví režim, ve kterém se mají zobrazit ovládací prvky pager v ovládacím prvku, který podporuje stránkování.

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

Hodnota vlastnosti

PagerButtons

Jedna z PagerButtons hodnot. Výchozí hodnota je PagerButtons.Numeric.

Výjimky

ArgumentOutOfRangeException

Je Mode nastavená na hodnotu, která není jednou z PagerButtons hodnot.

Příklady

Následující příklad kódu ukazuje, jak pomocí Mode vlastnosti určit, že řádek pager pro GridView ovládací prvek by měl zobrazovat číselná tlačítka.


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

Poznámky

Ovládací prvky, které podporují stránkování, poskytují více režimů, ve kterých se mají zobrazit ovládací prvky stránkování. Mode K určení režimu použijte vlastnost. Následující tabulka popisuje různé režimy pro ovládací prvky stránkování.

Mode Description
NextPrevious Tlačítka předchozí stránky a další stránky.
NextPreviousFirstLast Tlačítka předchozí stránky, další stránky, první stránky a poslední stránky.
Numeric Tlačítka číslovaných odkazů pro přímý přístup k stránkám.
NumericFirstLast Číslovaný a první odkaz a tlačítka posledního odkazu

Mode Pokud je vlastnost nastavena na NextPrevioushodnotu , NextPreviousFirstLastnebo NumericFirstLast hodnotu, můžete zadat vlastní text pro nečíselná tlačítka nastavením vlastností zobrazených v následující tabulce.

Vlastnictví Description
FirstPageText Text tlačítka první stránky
PreviousPageText Text tlačítka předchozí stránky
NextPageText Text tlačítka další stránky
LastPageText Text tlačítka poslední stránky

Jako alternativu můžete také zobrazit obrázky pro nečíselná tlačítka nastavením vlastností zobrazených v následující tabulce.

Vlastnictví Description
FirstPageImageUrl Adresa URL obrázku, který se má zobrazit pro tlačítko první stránky.
PreviousPageImageUrl Adresa URL obrázku, který se má zobrazit pro tlačítko předchozí stránky.
NextPageImageUrl Adresa URL obrázku, který se má zobrazit pro tlačítko další stránky.
LastPageImageUrl Adresa URL obrázku, který se má zobrazit u tlačítka poslední stránky.

Poznámka:

Pokud je nastavena vlastnost obrázku, odpovídající textová vlastnost funguje jako alternativní text obrázku. Například při FirstPageImageUrl nastavení vlastnosti se text FirstPageText určený vlastností zobrazí jako alternativní text obrázku. V prohlížečích, které podporují popisy tlačítek, se tento text zobrazí také jako popis tlačítka odpovídajícího tlačítka.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také