PagerSettings.Mode Vlastnost

  • Reference

Definice

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

Získá nebo nastaví režim, ve kterém se má zobrazit ovládací prvky pageru 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í formát je PagerButtons.Numeric.

Výjimky

ArgumentOutOfRangeException

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

Příklady

Následující příklad kódu ukazuje, jak použít Mode vlastnost k určení, ž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 ovládacích prvků stránkování.

Režim Description
NextPrevious Tlačítka předchozí stránky a další stránky.
NextPreviousFirstLast Tlačítka pro předchozí stránku, další stránku, první stránku a poslední stránku.
Numeric Tlačítka číslovaných odkazů pro přímé přístupové stránky.
NumericFirstLast Tlačítka číslování a prvního odkazu a posledního odkazu.

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

Vlastnost Popis
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

Alternativou je také zobrazení obrázků pro nečíselná tlačítka nastavením vlastností zobrazených v následující tabulce.

Vlastnost Popis
FirstPageImageUrl Adresa URL obrázku, který se zobrazí pro tlačítko první stránky.
PreviousPageImageUrl Adresa URL obrázku, který se má zobrazit pro předchozí tlačítko 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 pro tlačítko poslední stránky.

Poznámka

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

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

Platí pro

Viz také