PagerSettings Třída

Definice

Představuje vlastnosti ovládacích prvků stránkování v ovládacím prvku, který podporuje stránkování. Tuto třídu nelze zdědit.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
Dědičnost
PagerSettings
Atributy
Implementuje

Příklady

Následující příklad kódu ukazuje, jak použít PagerSettings objekt, který je obsažen ve PagerSettings vlastnosti přizpůsobit text tlačítek, které jsou zobrazeny v řádku GridView pager ovládacího prvku.


<%@ 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="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            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="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            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í (například GridView, DetailsViewa FormView ovládací prvky), mohou zobrazit sadu ovládacích prvků označovaných jako pager , které uživateli umožňují procházet stránky v ovládacím prvku. Třída PagerSettings je používána těmito ovládacími prvky k reprezentaci vlastností pageru. Obecně platí, že PagerSettings objekt je uložen ve PagerSettings vlastnosti ovládacího prvku. Pager můžete přizpůsobit nastavením vlastností objektu PagerSettings .

Pager podporuje několik různých režimů zobrazení. Chcete-li určit režim, ve kterém se má zobrazit pager, nastavte Mode vlastnost. Následující tabulka popisuje různé režimy.

Režim 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í -page.
Numeric Tlačítka číslovaných odkazů pro přímé přístupové stránky.
NumericFirstLast Tlačítka numbered-link, first-link a last-link.

Mode Pokud je vlastnost nastavena NextPreviousna hodnotu , NextPreviousFirstLastnebo NumericFirstLast můžete přizpůsobit text nečíselných tlačítek 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í, jak je znázorněno 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 zobrazí pro tlačítko další stránky.
LastPageImageUrl Adresa URL obrázku, který se zobrazí pro tlačítko poslední stránky.

Poznámka

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

Mode Pokud je vlastnost nastavena na Numeric hodnotu nebo NumericFirstLast hodnotu, můžete určit počet tlačítek stránky, která se mají zobrazit v pageru nastavením PageButtonCount vlastnosti.

Pager se dá zobrazit v horní, dolní nebo horní i dolní části ovládacího prvku. Chcete-li určit umístění pageru, nastavte Position vlastnost. Chcete-li zobrazit nebo skrýt pager, použijte Visible vlastnost.

Konstruktory

PagerSettings()

Inicializuje novou instanci PagerSettings třídy.

Vlastnosti

FirstPageImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko první stránky.

FirstPageText

Získá nebo nastaví text, který se má zobrazit pro tlačítko první stránky.

LastPageImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko poslední stránky.

LastPageText

Získá nebo nastaví text, který se má zobrazit pro tlačítko poslední stránky.

Mode

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í.

NextPageImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko další stránky.

NextPageText

Získá nebo nastaví text, který se má zobrazit pro tlačítko další stránky.

PageButtonCount

Získá nebo nastaví počet tlačítek stránky, která se mají zobrazit v pageru, když Mode je vlastnost nastavena na Numeric hodnotu nebo NumericFirstLast hodnotu.

Position

Získá nebo nastaví hodnotu, která určuje umístění, kde se pager zobrazí.

PreviousPageImageUrl

Získá nebo nastaví adresu URL na obrázek, který se zobrazí pro tlačítko předchozí stránky.

PreviousPageText

Získá nebo nastaví text, který se má zobrazit pro předchozí tlačítko stránky.

Visible

Získá nebo nastaví hodnotu označující, zda jsou ovládací prvky stránkování zobrazeny v ovládacím prvku, který podporuje stránkování.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
ToString()

Načte řetězcovou reprezentaci objektu PagerSettings .

událost

PropertyChanged

Nastane, když vlastnost objektu PagerSettings změní hodnoty.

Explicitní implementace rozhraní

IStateManager.IsTrackingViewState

Získá hodnotu, která označuje, zda ovládací prvek serveru sleduje změny stavu zobrazení.

IStateManager.LoadViewState(Object)

Načte dříve uložený stav zobrazení objektu PagerSettings .

IStateManager.SaveViewState()

Uloží aktuální stav zobrazení objektu PagerSettings .

IStateManager.TrackViewState()

Označí výchozí bod, ve kterém chcete začít sledovat a ukládat změny stavu zobrazení objektu PagerSettings .

Platí pro

Viz také