NumericPagerField Třída

Definice

DataPager Představuje pole, které umožňuje uživatelům vybrat stránku podle čísla stránky.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
Dědičnost
NumericPagerField

Příklady

Následující příklad ukazuje, jak použít NumericPagerField objekt k procházení dat, která jsou zobrazena v ovládacím ListView 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Poznámky

Třída NumericPagerField zobrazí ovládací prvky navigace v ovládacím DataPager prvku. Ovládací prvky lze použít k procházení dat zobrazených ovládacím prvek, který implementuje IPageableItemContainer rozhraní, jako ListView je například ovládací prvek. Objekt NumericPagerField zobrazí čísla stránek jako tlačítka, na která se uživatelé můžou kliknutím přesunout na konkrétní stránku. Ovládací prvek také zobrazuje tlačítka další a předchozí stránky, která uživatelům umožňují přístup k více stránkám dat, než jsou stránky zobrazené ovládacím prvek.

Vzhled objektu NumericPagerField můžete přizpůsobit pomocí vlastností uvedených v následující tabulce.

Vlastnost Popis
CurrentPageLabelCssClass Třída CSS pro aktuální číslo stránky.
NextPreviousButtonCssClass Třída CSS pro tlačítka další stránky a předchozí stránky.
NumericButtonCssClass Třída CSS pro tlačítka, která představují čísla stránek.

Pomocí vlastnosti můžete ButtonType vybrat typ tlačítka, které se zobrazí. Následující tabulka uvádí dostupné typy tlačítek.

Typ tlačítka Description
ButtonType.Button Ovládací Button prvek.
ButtonType.Image Ovládací ImageButton prvek.
ButtonType.Link Ovládací LinkButton prvek.

Ovládací prvky uvnitř objektu NumericButtonCssClass se vykreslují s nepřerušovanými mezerami mezi nimi. Pokud chcete toto chování přizpůsobit, můžete použít RenderNonBreakingSpacesBetweenControls vlastnost .

Objekt v ovládacím NumericPagerFieldDataPager prvku můžete skrýt nastavením Visible vlastnosti na false. Viditelnost tlačítek další a předchozí stránky nelze řídit. Ovládací prvek je zobrazí, pokud má přidružený ovládací prvek dat k dispozici další stránky. Vlastnost můžete použít ButtonCount k určení počtu tlačítek zobrazených v objektu NumericPagerField . Každé tlačítko odpovídá číslu stránky.

Text tlačítka další stránky můžete nastavit nastavením NextPageText vlastnosti . Text tlačítka předchozí stránky můžete nastavit pomocí PreviousPageText vlastnosti .

Pokud je vlastnost nastavená ButtonType na ButtonType.Image, musíte zadat adresu URL obrázku, který se zobrazí pro tlačítka další a předchozí stránky. Provedete to nastavením NextPageImageUrl vlastností a PreviousPageImageUrl . V takovém případě se jako alternativní text obrázku použije odpovídající vlastnost text. Například text určený NextPageImageUrl vlastností se zobrazí jako alternativní text tlačítka obrázku další stránky. V prohlížečích, které podporují popisy, se tento text zobrazí také jako popis odpovídajícího tlačítka.

Konstruktory

NumericPagerField()

Inicializuje novou instanci NumericPagerField třídy .

Vlastnosti

ButtonCount

Získá nebo nastaví počet tlačítek k zobrazení v objektu NumericPagerField .

ButtonType

Získá nebo nastaví typ tlačítka k zobrazení v pager pole.

CurrentPageLabelCssClass

Získá nebo nastaví kaskádové šablony stylů (CSS) třídy, která se používá k vytvoření stylu aktuální číslo stránky.

DataPager

Získá odkaz na data pager, který DataPagerField je přidružen objektu.

(Zděděno od DataPagerField)
IsTrackingViewState

Získá hodnotu, která označuje, zda DataPagerField objekt sleduje své změny stavu zobrazení.

(Zděděno od DataPagerField)
NextPageImageUrl

Získá nebo nastaví adresu URL obrázku, který je zobrazen pro tlačítko další stránky v objektu NumericPagerField .

NextPageText

Získá nebo nastaví text, který je zobrazen pro tlačítko další stránky.

NextPreviousButtonCssClass

Získá nebo nastaví kaskádové šablony stylů (CSS) třídy, která se používá pro styl tlačítka další stránky a předchozí stránky pager pole.

NumericButtonCssClass

Získá nebo nastaví kaskádové šablony stylů (CSS) třídy, která se používá k vytvoření stylu page-number tlačítka pager pole.

PreviousPageImageUrl

Získá nebo nastaví adresu URL obrázku, který je zobrazen pro tlačítko předchozí stránky v objektu NumericPagerField .

PreviousPageText

Získá nebo nastaví text, který je zobrazen pro předchozí stránku tlačítko.

QueryStringHandled

Získá nebo nastaví hodnotu, která označuje, zda pole řetězce dotazu bylo vyhodnoceno.

(Zděděno od DataPagerField)
QueryStringValue

Získá hodnotu pole řetězce dotazu z adresy URL požadavku.

(Zděděno od DataPagerField)
RenderNonBreakingSpacesBetweenControls

Získá nebo nastaví hodnotu, která označuje, zda budou mezi ovládacími prvky vykreslovány nezlomné mezery.

ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataPagerField v rámci více požadavků na stejnou stránku.

(Zděděno od DataPagerField)
Visible

Získá nebo nastaví hodnotu, která označuje, zda data pager pole je vykreslena.

(Zděděno od DataPagerField)

Metody

CloneField()

Vytvoří kopii aktuálního objektu odvozeného z DataPagerField.

(Zděděno od DataPagerField)
CopyProperties(DataPagerField)

Zkopíruje vlastnosti aktuálního NumericPagerField objektu do zadaného DataPagerField objektu.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Vytvoří ovládací prvky uživatelského rozhraní (UI) pro objekt pole pager a přidá je do zadaného kontejneru.

CreateField()

Vytvoří a vrátí novou instanci NumericPagerField třídy .

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu NumericPagerField objektu.

GetHashCode()

Slouží jako hashovací funkce pro NumericPagerField třídu .

GetQueryStringNavigateUrl(Int32)

Vytvoří adresu URL obsahující pole řetězce dotazu se zadaným číslem stránky.

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

Type Získá z aktuální instance.

(Zděděno od Object)
HandleEvent(CommandEventArgs)

Zpracovává události, ke kterým dochází v objektu NumericPagerField , a provede příslušnou akci.

LoadViewState(Object)

Obnoví dříve uložené informace o stavu zobrazení.

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

Vytvoří mělkou kopii aktuálního Objectsouboru .

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

FieldChanged Vyvolá událost.

(Zděděno od DataPagerField)
SaveViewState()

Uloží změny provedené ve stavu zobrazení objektu DataPagerField .

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

Vrátí řetězec, který představuje aktuální objekt.

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

Způsobí, DataPagerField že objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataPagerField)

Explicitní implementace rozhraní

IStateManager.IsTrackingViewState

Získá hodnotu, která označuje, zda DataPagerField objekt sleduje své změny stavu zobrazení.

(Zděděno od DataPagerField)
IStateManager.LoadViewState(Object)

Obnoví dříve uložené informace o stavu zobrazení.

(Zděděno od DataPagerField)
IStateManager.SaveViewState()

Uloží změny provedené ve stavu zobrazení objektu DataPagerField .

(Zděděno od DataPagerField)
IStateManager.TrackViewState()

Způsobí, DataPagerField že objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataPagerField)

Platí pro

Viz také