PagerSettings Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object
PagerSettings

Atributy: TypeConverterAttribute

Implementuje: IStateManager

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

Sdílet prostřednictvím