NumericPagerField Třída

Definice

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

Sestavení:: System.Web.Extensions.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í.

DataPager Představuje pole, které uživatelům umožňuje 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: Object

DataPagerField
NumericPagerField

Příklady

Následující příklad ukazuje, jak pomocí objektu NumericPagerField stránkovat prostřednictvím dat zobrazených 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 zobrazuje navigační ovládací prvky v ovládacím DataPager prvku. Ovládací prvky lze použít ke stránkování dat, která jsou zobrazena ovládacím prvku, který implementuje IPageableItemContainer rozhraní, jako ListView je například ovládací prvek. Objekt NumericPagerField zobrazí čísla stránek jako tlačítka, na která můžou uživatelé kliknout a přejít na konkrétní stránku. Ovládací prvek také zobrazuje tlačítka další stránky a předchozí stránky, která uživatelům umožňují přístup k více stránkám dat než k těm, které ovládací prvek zobrazuje.

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

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

Vlastnost můžete použít ButtonType k výběru typu 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 neprolomenými mezerami. Pokud chcete toto chování přizpůsobit, můžete použít RenderNonBreakingSpacesBetweenControls vlastnost.

Objekt v ovládacím DataPager prvku můžete skrýt NumericPagerField nastavením Visible vlastnosti na falsehodnotu . Viditelnost tlačítek další stránky a předchozí stránky nelze ovládat. Pokud má přidružený datový ovládací prvek k dispozici další stránky k zobrazení, zobrazí je ovládací prvek. Pomocí vlastnosti můžete ButtonCount určit, kolik tlačítek se zobrazí 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 nastavena ButtonType na ButtonType.Image, musíte zadat adresu URL obrázku, který se zobrazí pro tlačítka další stránky a předchozí stránky. Provedete to nastavením NextPageImageUrl vlastností a PreviousPageImageUrl vlastností. V takovém případě se odpovídající textová vlastnost použije jako alternativní text obrázku. 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

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

Vlastnosti

Name	Description
ButtonCount	Získá nebo nastaví počet tlačítek, která se mají zobrazit v objektu NumericPagerField .
ButtonType	Získá nebo nastaví typ tlačítka pro zobrazení v poli pager.
CurrentPageLabelCssClass	Získá nebo nastaví kaskádovou šablonu stylů (CSS), která se používá ke stylu aktuální číslo stránky.
DataPager	Získá odkaz na datový pager, ke kterému DataPagerField je objekt přidružen. (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ý se zobrazí pro tlačítko další stránky v objektu NumericPagerField .
NextPageText	Získá nebo nastaví text, který se zobrazí pro tlačítko další stránky.
NextPreviousButtonCssClass	Získá nebo nastaví kaskádovou šablonu stylů (CSS), která se používá ke stylu další stránky a tlačítka předchozí stránky pole pager.
NumericButtonCssClass	Získá nebo nastaví kaskádovou šablonu stylů (CSS), která se používá ke stylu tlačítek číslování stránek pole pager.
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ý se zobrazí pro tlačítko předchozí stránky.
QueryStringHandled	Získá nebo nastaví hodnotu, která označuje, zda bylo pole řetězce dotazu 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 se mezery, které se nerozbití vykreslují mezi ovládacími prvky.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataPagerField napříč více požadavky na stejnou stránku. (Zděděno od DataPagerField)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je pole datové stránky vykresleno. (Zděděno od DataPagerField)

Metody

Name	Description
CloneField()	Vytvoří kopii aktuálního objektu, který je odvozen 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, které má zadané číslo stránky. (Zděděno od DataPagerField)
GetType()	Type Získá aktuální instanci. (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í informace o stavu zobrazení, které byly uloženy dříve. (Zděděno od DataPagerField)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 jeho stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataPagerField)

Explicitní implementace rozhraní

Name	Description
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í informace o stavu zobrazení, které byly uloženy dříve. (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 jeho stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataPagerField)

Platí pro

Viz také

Váš názor

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