NextPreviousPagerField Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.Extensions.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

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 nawigowanie po stronach danych pojedynczo 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ć ButtonType właściwości , 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żesz 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ślanie niestandardowego tekstu dla każdego przycisku przy użyciu FirstPageTextwłaściwości , PreviousPageText, NextPageTexti LastPageText .

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

Gdy właściwość jest ustawiona ButtonType na ButtonType.Imagewartość , 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.

Konstruktorów

Nazwa	Opis
NextPreviousPagerField()	Inicjuje nowe wystąpienie klasy NextPreviousPagerField.

Właściwości

Nazwa	Opis
ButtonCssClass	Pobiera lub ustawia klasę kaskadowego 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 stronicatora danych skojarzonego DataPagerField z obiektem. (Dziedziczone od 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. (Dziedziczone od 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 strony w NextPreviousPagerField 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. (Dziedziczone od DataPagerField)
QueryStringValue	Pobiera wartość pola ciągu zapytania z adresu URL żądania. (Dziedziczone od 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. (Dziedziczone od DataPagerField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole stronicowania danych jest renderowane. (Dziedziczone od DataPagerField)

Metody

Nazwa	Opis
CloneField()	Tworzy kopię bieżącego obiektu, który pochodzi z DataPagerField. (Dziedziczone od 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 z określonym numerem strony. (Dziedziczone od DataPagerField)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od 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 wcześniej zapisane. (Dziedziczone od DataPagerField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Dziedziczone od DataPagerField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataPagerField stanie widoku obiektu. (Dziedziczone od DataPagerField)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)
TrackViewState()	DataPagerField Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Dziedziczone od DataPagerField)

Implementacje interfejsów jawnych

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

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?