NumericPagerField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.Extensions.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

DataPager Reprezentuje pole, które umożliwia użytkownikom wybranie strony według numeru strony.

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

Dziedziczenie: Object

DataPagerField
NumericPagerField

Przykłady

W poniższym przykładzie pokazano, jak używać NumericPagerField obiektu do stronicowania danych wyświetlanych w kontrolce ListView .

<%@ 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>

Uwagi

Klasa NumericPagerField wyświetla kontrolki nawigacji w kontrolce DataPager . Kontrolki mogą służyć do stronicowania danych wyświetlanych przez kontrolkę, która implementuje IPageableItemContainer interfejs, taki jak kontrolka ListView . Obiekt NumericPagerField wyświetla numery stron jako przyciski, które użytkownicy mogą kliknąć, aby przejść do określonej strony. Kontrolka wyświetla również przyciski następnej strony i poprzedniej strony, które umożliwiają użytkownikom dostęp do większej liczby stron danych niż te, które są wyświetlane przez kontrolkę.

Wygląd obiektu można dostosować NumericPagerField przy użyciu właściwości wymienionych w poniższej tabeli.

Właściwość	Opis
CurrentPageLabelCssClass	Klasa CSS dla bieżącego numeru strony.
NextPreviousButtonCssClass	Klasa CSS dla przycisków następnej strony i poprzedniej strony.
NumericButtonCssClass	Klasa CSS dla przycisków reprezentujących numery stron.

Możesz użyć właściwości , ButtonType aby wybrać typ przycisku, który zostanie wyświetlony. W poniższej tabeli wymieniono dostępne typy przycisków.

Typ przycisku	Opis
ButtonType.Button	Kontrolka Button .
ButtonType.Image	Kontrolka ImageButton .
ButtonType.Link	Kontrolka LinkButton .

Kontrolki wewnątrz NumericButtonCssClass obiektu są renderowane z niełamanymi spacjami między nimi. Jeśli chcesz dostosować to zachowanie, możesz użyć RenderNonBreakingSpacesBetweenControls właściwości .

Obiekt można ukryć NumericPagerField w kontrolce DataPager , ustawiając Visible właściwość na false. Nie można kontrolować widoczności przycisków następnej strony i poprzednich stron. Są one wyświetlane przez kontrolkę, jeśli skojarzona kontrolka danych ma dostępne dodatkowe strony do wyświetlenia. Za pomocą ButtonCount właściwości można określić liczbę przycisków wyświetlanych w NumericPagerField obiekcie. Każdy przycisk odpowiada numerowi strony.

Tekst przycisku następnej strony można ustawić, ustawiając NextPageText właściwość. Tekst przycisku poprzedniej strony można ustawić przy użyciu PreviousPageText właściwości .

Po ustawieniu ButtonType właściwości na ButtonType.Imagewartość , należy podać adres URL obrazu, który będzie wyświetlany dla przycisków następnej strony i poprzedniej strony. W tym celu należy ustawić NextPageImageUrl właściwości i PreviousPageImageUrl . W takim przypadku odpowiednia właściwość tekstowa jest używana jako tekst alternatywny obrazu. Na przykład tekst określony przez NextPageImageUrl właściwość jest wyświetlany jako tekst alternatywny przycisku obrazu na następnej stronie. W przeglądarkach obsługujących etykietki narzędzi ten tekst jest również wyświetlany jako etykietka narzędzia odpowiedniego przycisku.

Konstruktory

NumericPagerField()

Inicjuje nowe wystąpienie klasy NumericPagerField.

Właściwości

ButtonCount	Pobiera lub ustawia liczbę przycisków do wyświetlenia w NumericPagerField obiekcie.
ButtonType	Pobiera lub ustawia typ przycisku do wyświetlenia w polu pager.
CurrentPageLabelCssClass	Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS), która jest używana do stylu bieżącego numeru strony.
DataPager	Pobiera odwołanie do stronicowania danych skojarzonego DataPagerField z obiektem. (Odziedziczone po DataPagerField)
IsTrackingViewState	Pobiera wartość wskazującą, czy DataPagerField obiekt śledzi zmiany stanu widoku. (Odziedziczone po DataPagerField)
NextPageImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego dla przycisku następnej strony w NumericPagerField obiekcie.
NextPageText	Pobiera lub ustawia tekst wyświetlany dla przycisku następnej strony.
NextPreviousButtonCssClass	Pobiera lub ustawia kaskadową klasę arkusza stylów (CSS), która służy do stylu przycisków następnej strony i poprzednich stron pola pager.
NumericButtonCssClass	Pobiera lub ustawia kaskadową klasę arkusza stylów (CSS), która służy do stylu przycisków numerów strony pola pager.
PreviousPageImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego dla przycisku poprzedniej NumericPagerField strony w obiekcie.
PreviousPageText	Pobiera lub ustawia tekst wyświetlany dla przycisku poprzedniej strony.
QueryStringHandled	Pobiera lub ustawia wartość wskazującą, czy pole ciągu zapytania zostało ocenione. (Odziedziczone po DataPagerField)
QueryStringValue	Pobiera wartość pola ciągu zapytania z adresu URL żądania. (Odziedziczone po DataPagerField)
RenderNonBreakingSpacesBetweenControls	Pobiera lub ustawia wartość wskazującą, czy spacje powodujące niezgodność zostaną renderowane między kontrolkami.
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisywanie i przywracanie stanu DataPagerField widoku obiektu w wielu żądaniach dla tej samej strony. (Odziedziczone po DataPagerField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole stronicowania danych jest renderowane. (Odziedziczone po DataPagerField)

Metody

CloneField()	Tworzy kopię bieżącego obiektu, który pochodzi z DataPagerFieldklasy . (Odziedziczone po DataPagerField)
CopyProperties(DataPagerField)	Kopiuje właściwości bieżącego NumericPagerField obiektu do określonego DataPagerField obiektu.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Tworzy kontrolki interfejsu użytkownika dla obiektu pola pager i dodaje je do określonego kontenera.
CreateField()	Tworzy i zwraca nowe wystąpienie NumericPagerField klasy.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu NumericPagerField obiektowi.
GetHashCode()	Służy jako funkcja skrótu NumericPagerField dla klasy.
GetQueryStringNavigateUrl(Int32)	Tworzy adres URL zawierający pole ciągu zapytania, które ma określony numer strony. (Odziedziczone po DataPagerField)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HandleEvent(CommandEventArgs)	Obsługuje zdarzenia występujące w NumericPagerField obiekcie i wykonuje odpowiednią akcję.
LoadViewState(Object)	Przywraca informacje o stanie widoku, które zostały zapisane wcześniej. (Odziedziczone po DataPagerField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Odziedziczone po DataPagerField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataPagerField stanie widoku obiektu. (Odziedziczone po DataPagerField)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	DataPagerField Powoduje, że obiekt śledzi zmiany w stanie widoku, aby można je było przechowywać we właściwości kontrolki ViewState i utrwalać na żądaniach dla tej samej strony. (Odziedziczone po DataPagerField)

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataPagerField obiekt śledzi zmiany stanu widoku. (Odziedziczone po DataPagerField)
IStateManager.LoadViewState(Object)	Przywraca informacje o stanie widoku, które zostały zapisane wcześniej. (Odziedziczone po DataPagerField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataPagerField stanie widoku obiektu. (Odziedziczone po DataPagerField)
IStateManager.TrackViewState()	DataPagerField Powoduje, że obiekt śledzi zmiany w stanie widoku, aby można je było przechowywać we właściwości kontrolki ViewState i utrwalać na żądaniach dla tej samej strony. (Odziedziczone po DataPagerField)

Dotyczy