NextPreviousPagerField Klas

Definitie

Vertegenwoordigt een veld dat navigatiebesturingselementen weergeeft in een DataPager besturingselement, zodat gebruikers door gegevens kunnen bladeren.

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

Voorbeelden

In het volgende voorbeeld ziet u hoe u een NextPreviousPagerField object gebruikt om door gegevens te bladeren die in een ListView besturingselement worden weergegeven.

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

Opmerkingen

De NextPreviousPagerField klasse vertegenwoordigt een veld dat navigatiebesturingselementen in een DataPager besturingselement weergeeft. Deze navigatiebesturingselementen kunnen worden gebruikt om door gegevens te bladeren die worden weergegeven door een besturingselement waarmee de IPageableItemContainer interface wordt geïmplementeerd, zoals het ListView besturingselement.

De NextPreviousPagerField klasse bevat knoppen waarmee gebruikers door de pagina's met gegevens kunnen navigeren, één pagina tegelijk, of om naar de eerste of laatste pagina met gegevens te gaan.

U kunt het uiterlijk van het NextPreviousPagerField object aanpassen met behulp van de ButtonCssClass eigenschap om de stijl van de knoppen in te stellen. U kunt de ButtonType eigenschap ook gebruiken om het type knop te kiezen dat wordt weergegeven. De volgende tabel bevat de beschikbare knoptypen.

Knoptype Beschrijving
Button Een Button besturingselement.
Image Een ImageButton besturingselement.
Link Een LinkButton besturingselement.

U kunt een NextPreviousPagerField object in een DataPager besturingselement verbergen door de Visible eigenschap in te stellen op false. U kunt de afzonderlijke knoppen (de knoppen voor de eerste pagina, vorige pagina, volgende pagina en laatste pagina) ook verbergen door de ShowFirstPageButton, ShowPreviousPageButtonen ShowNextPageButtoneigenschappen ShowLastPageButton in te stellen op false.

NextPreviousPagerField Met het besturingselement kunt u aangepaste tekst opgeven voor elke knop met behulp van de FirstPageText, PreviousPageTextNextPageTexten eigenschappenLastPageText.

Wanneer de ButtonType eigenschap is ingesteld op ButtonType.Image, moet u de URL opgeven voor een afbeelding die voor de knop wordt weergegeven. U kunt afbeeldingen afzonderlijk voor elke knop instellen door de FirstPageImageUrl, PreviousPageImageUrlen NextPageImageUrleigenschappen LastPageImageUrl in te stellen.

Wanneer de ButtonType eigenschap is ingesteld op ButtonType.Image, fungeert de bijbehorende teksteigenschap als de alternatieve tekst voor de afbeelding. De tekst die door de FirstPageText eigenschap is opgegeven, wordt bijvoorbeeld weergegeven als alternatieve tekst voor de knop Afbeelding van de eerste pagina. In browsers die knopinfo ondersteunen, wordt deze tekst ook weergegeven als knopinfo.

Constructors

Name Description
NextPreviousPagerField()

Initialiseert een nieuw exemplaar van de NextPreviousPagerField klasse.

Eigenschappen

Name Description
ButtonCssClass

Hiermee haalt u de CSS-klasse (cascading style sheet) op die wordt gebruikt om de knoppen van het paginaveld in de browser weer te geven.

ButtonType

Hiermee haalt u het knoptype op of stelt u dit in om weer te geven in het paginaveld.

DataPager

Hiermee haalt u een verwijzing op naar de gegevenspagina waaraan het DataPagerField object is gekoppeld.

(Overgenomen van DataPagerField)
FirstPageImageUrl

Hiermee haalt u de URL op of stelt u deze in op een afbeelding die wordt weergegeven voor de knop eerste pagina.

FirstPageText

Hiermee haalt u de tekst op die wordt weergegeven voor de knop eerste pagina of stelt u deze in.

IsTrackingViewState

Hiermee wordt een waarde opgehaald die aangeeft of het object wijzigingen in de DataPagerField weergavestatus bijhoudt.

(Overgenomen van DataPagerField)
LastPageImageUrl

Hiermee haalt u de URL op of stelt u de URL in op een afbeelding die wordt weergegeven voor de knop laatste pagina in het NextPreviousPagerField object.

LastPageText

Hiermee haalt u de tekst op die wordt weergegeven voor de knop laatste pagina of stelt u deze in.

NextPageImageUrl

Hiermee haalt u de URL op of stelt u de URL in op een afbeelding die wordt weergegeven voor de knop volgende pagina in het NextPreviousPagerField object.

NextPageText

Hiermee haalt u de tekst op die wordt weergegeven voor de knop volgende pagina of stelt u deze in.

PreviousPageImageUrl

Hiermee haalt u de URL op of stelt u deze in op een afbeelding die wordt weergegeven voor de knop vorige pagina in het NextPreviousPagerField object.

PreviousPageText

Hiermee haalt u de tekst op die wordt weergegeven voor de knop vorige pagina of stelt u deze in.

QueryStringHandled

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het querytekenreeksveld is geëvalueerd.

(Overgenomen van DataPagerField)
QueryStringValue

Hiermee haalt u de waarde van het querytekenreeksveld op uit de URL van de aanvraag.

(Overgenomen van DataPagerField)
RenderDisabledButtonsAsLabels

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of uitgeschakelde knoppen worden weergegeven als Label besturingselementen door het NextPreviousPagerField object.

RenderNonBreakingSpacesBetweenControls

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of niet-brekende spaties tussen besturingselementen worden weergegeven.

ShowFirstPageButton

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de knop voor de eerste pagina wordt weergegeven in een NextPreviousPagerField object.

ShowLastPageButton

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de knop laatste pagina wordt weergegeven in een NextPreviousPagerField object.

ShowNextPageButton

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de knop volgende pagina wordt weergegeven in een NextPreviousPagerField object.

ShowPreviousPageButton

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de knop vorige pagina wordt weergegeven in een NextPreviousPagerField object.

ViewState

Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een DataPagerField object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina.

(Overgenomen van DataPagerField)
Visible

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een gegevenspaginaveld wordt weergegeven.

(Overgenomen van DataPagerField)

Methoden

Name Description
CloneField()

Hiermee maakt u een kopie van het huidige object dat is afgeleid van DataPagerField.

(Overgenomen van DataPagerField)
CopyProperties(DataPagerField)

Kopieert de eigenschappen van het huidige NextPreviousPagerField object naar het opgegeven DataPagerField object.

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

Hiermee maakt u de besturingselementen voor de gebruikersinterface (UI) voor het pager-veldobject en voegt u deze toe aan de opgegeven container.

CreateField()

Hiermee maakt en retourneert u een nieuw exemplaar van de NextPreviousPagerField klasse.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige NextPreviousPagerField object.

GetHashCode()

Fungeert als een hash-functie voor de NextPreviousPagerField klasse.

GetQueryStringNavigateUrl(Int32)

Hiermee maakt u een URL die een querytekenreeksveld bevat met het opgegeven paginanummer.

(Overgenomen van DataPagerField)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
HandleEvent(CommandEventArgs)

Verwerkt gebeurtenissen die zich in het NextPreviousPagerField besturingselement voordoen en voert de juiste actie uit.

LoadViewState(Object)

Hiermee herstelt u informatie over de weergavestatus die eerder is opgeslagen.

(Overgenomen van DataPagerField)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnFieldChanged()

Hiermee wordt de FieldChanged gebeurtenis gegenereerd.

(Overgenomen van DataPagerField)
SaveViewState()

Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de weergavestatus van het DataPagerField object.

(Overgenomen van DataPagerField)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
TrackViewState()

Hiermee zorgt u ervoor dat het DataPagerField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina.

(Overgenomen van DataPagerField)

Expliciete interface-implementaties

Name Description
IStateManager.IsTrackingViewState

Hiermee wordt een waarde opgehaald die aangeeft of het object wijzigingen in de DataPagerField weergavestatus bijhoudt.

(Overgenomen van DataPagerField)
IStateManager.LoadViewState(Object)

Hiermee herstelt u informatie over de weergavestatus die eerder is opgeslagen.

(Overgenomen van DataPagerField)
IStateManager.SaveViewState()

Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de weergavestatus van het DataPagerField object.

(Overgenomen van DataPagerField)
IStateManager.TrackViewState()

Hiermee zorgt u ervoor dat het DataPagerField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina.

(Overgenomen van DataPagerField)

Van toepassing op

Zie ook