PagerSettings Třída

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

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í -page.
Numeric	Tlačítka číslovaných odkazů pro přímý přístup k stránkám.
NumericFirstLast	Tlačítka číslovaný odkaz, první odkaz a poslední odkaz

Mode Pokud je vlastnost nastavena na NextPrevioushodnotu , NextPreviousFirstLastnebo NumericFirstLast hodnotu můžete přizpůsobit text nečíselných tlačítek 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í, jak je znázorněno 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.

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 zadat pozici pager, nastavte Position vlastnost. Chcete-li zobrazit nebo skrýt pager, použijte Visible vlastnost.

Konstruktory

Name	Description
PagerSettings()	Inicializuje novou instanci PagerSettings třídy.

Vlastnosti

Name	Description
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 mají zobrazit ovládací prvky pager 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 Numeric na 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 určující, zda stránkovací ovládací prvky jsou zobrazeny v ovládacím prvku, který podporuje stránkování.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven 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ří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Načte řetězcovou reprezentaci objektu PagerSettings .

Událost

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

Explicitní implementace rozhraní

Name	Description
IStateManager.IsTrackingViewState	Získá hodnotu, která určuje, zda serverový ovládací prvek 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é

Váš názor

Byla tato stránka užitečná?