NextPreviousPagerField 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.

Reprezentuje pole, które wyświetla kontrolki nawigacji w kontrolce DataPager , aby umożliwić użytkownikom stronicowanie danych.

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField

public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField

type NextPreviousPagerField = class
    inherit DataPagerField

Public Class NextPreviousPagerField
Inherits DataPagerField

Dziedziczenie: Object

DataPagerField
NextPreviousPagerField

Przykłady

W poniższym przykładzie pokazano, jak używać NextPreviousPagerField 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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 NextPreviousPagerField reprezentuje pole, które wyświetla kontrolki nawigacji w kontrolce DataPager . Te kontrolki nawigacji mogą służyć do stronicowania danych wyświetlanych przez kontrolkę, która implementuje IPageableItemContainer interfejs, taki jak kontrolka ListView .

Klasa NextPreviousPagerField udostępnia przyciski, które umożliwiają użytkownikom przechodzenie przez strony danych jednej strony naraz lub przechodzenie do pierwszej lub ostatniej strony danych.

Wygląd obiektu można dostosować NextPreviousPagerField przy użyciu ButtonCssClass właściwości , aby ustawić styl przycisków. Możesz również użyć właściwości , ButtonType aby wybrać typ wyświetlanego przycisku. W poniższej tabeli wymieniono dostępne typy przycisków.

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

Obiekt można ukryć NextPreviousPagerField w kontrolce DataPager , ustawiając Visible właściwość na false. Można również ukryć poszczególne przyciski (pierwsza strona, poprzednia strona, następna strona i przyciski ostatniej strony), ustawiając ShowFirstPageButtonwłaściwości , ShowPreviousPageButton, ShowNextPageButtoni ShowLastPageButton na falsewartość .

Kontrolka NextPreviousPagerField umożliwia określenie niestandardowego tekstu dla każdego przycisku przy użyciu FirstPageTextwłaściwości , PreviousPageText, NextPageTexti LastPageText .

Po ustawieniu ButtonType właściwości na ButtonType.Imagewartość , należy podać adres URL obrazu, który będzie wyświetlany dla przycisku. Obrazy można ustawić indywidualnie dla każdego przycisku, ustawiając FirstPageImageUrlwłaściwości , PreviousPageImageUrl, NextPageImageUrli LastPageImageUrl .

ButtonType Gdy właściwość jest ustawiona na ButtonType.Image, odpowiednia właściwość tekstowa działa jako tekst alternatywny obrazu. Na przykład tekst określony przez FirstPageText właściwość jest wyświetlany jako tekst alternatywny przycisku obrazu pierwszej strony. W przeglądarkach obsługujących etykietki narzędzi ten tekst jest również wyświetlany jako etykietka narzędzia.

Konstruktory

NextPreviousPagerField()

Inicjuje nowe wystąpienie klasy NextPreviousPagerField.

Właściwości

ButtonCssClass	Pobiera lub ustawia kaskadową klasę arkusza stylów (CSS), która jest używana do renderowania przycisków pola pager w przeglądarce.
ButtonType	Pobiera lub ustawia typ przycisku do wyświetlenia w polu pager.
DataPager	Pobiera odwołanie do stronicowania danych skojarzonego DataPagerField z obiektem. (Odziedziczone po DataPagerField)
FirstPageImageUrl	Pobiera lub ustawia adres URL na obraz wyświetlany dla przycisku pierwszej strony.
FirstPageText	Pobiera lub ustawia tekst wyświetlany dla przycisku pierwszej strony.
IsTrackingViewState	Pobiera wartość wskazującą, czy DataPagerField obiekt śledzi zmiany stanu widoku. (Odziedziczone po DataPagerField)
LastPageImageUrl	Pobiera lub ustawia adres URL na obraz wyświetlany dla przycisku ostatniej strony w NextPreviousPagerField obiekcie.
LastPageText	Pobiera lub ustawia tekst wyświetlany dla przycisku ostatniej strony.
NextPageImageUrl	Pobiera lub ustawia adres URL na obraz wyświetlany dla przycisku następnej NextPreviousPagerField strony w obiekcie.
NextPageText	Pobiera lub ustawia tekst wyświetlany dla przycisku następnej strony.
PreviousPageImageUrl	Pobiera lub ustawia adres URL na obraz wyświetlany dla przycisku poprzedniej NextPreviousPagerField 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)
RenderDisabledButtonsAsLabels	Pobiera lub ustawia wartość wskazującą, czy wyłączone przyciski są renderowane jako Label kontrolki przez NextPreviousPagerField obiekt.
RenderNonBreakingSpacesBetweenControls	Pobiera lub ustawia wartość, która wskazuje, czy spacje nienależące są renderowane między kontrolkami.
ShowFirstPageButton	Pobiera lub ustawia wartość wskazującą, czy przycisk pierwszej strony jest wyświetlany w NextPreviousPagerField obiekcie.
ShowLastPageButton	Pobiera lub ustawia wartość wskazującą, czy ostatni przycisk strony jest wyświetlany w NextPreviousPagerField obiekcie.
ShowNextPageButton	Pobiera lub ustawia wartość wskazującą, czy przycisk następnej NextPreviousPagerField strony jest wyświetlany w obiekcie.
ShowPreviousPageButton	Pobiera lub ustawia wartość wskazującą, czy przycisk poprzedniej NextPreviousPagerField strony jest wyświetlany w obiekcie.
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 NextPreviousPagerField 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 NextPreviousPagerField klasy.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu NextPreviousPagerField obiektowi.
GetHashCode()	Służy jako funkcja skrótu NextPreviousPagerField 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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
HandleEvent(CommandEventArgs)	Obsługuje zdarzenia występujące w kontrolce NextPreviousPagerField 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