DetailsView.AllowPaging Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de wisselfunctie is ingeschakeld.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean

Waarde van eigenschap

Boolean

true om de wisselfunctie in te schakelen; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AllowPaging eigenschap gebruikt om de pagingmogelijkheden van het DetailsView besturingselement in te schakelen.

<%@ 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 runat="server">
    <title>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </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 runat="server">
    <title>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Opmerkingen

Het DetailsView besturingselement heeft ingebouwde pagineringsmogelijkheden, waarmee een gebruiker naar een andere record in de gegevensbron kan navigeren.

Het DetailsView besturingselement kan zowel gebruikersinterface (UI) als paginering van gegevensbronnen uitvoeren. De functie voor paging van de gebruikersinterface kan worden gebruikt met elk gegevensbronobject dat ondersteuning biedt voor de System.Collections.ICollection interface. Voor elke pagingbewerking voert het DetailsView besturingselement een query uit op de gegevensbron voor de volledige gegevensverzameling en selecteert de rij die moet worden weergegeven, waardoor de resterende gegevens in wezen worden verwijderd.

Als een gegevensbron implementeert DataSourceView en de CanPage eigenschap retourneert true, gebruikt het DetailsView besturingselement paging van gegevensbronnen in plaats van paging van de gebruikersinterface. In dit geval wordt met het DetailsView besturingselement alleen een query uitgevoerd op de rij die nodig is voor elke pagingbewerking. Daarom is paging van gegevensbronnen efficiënter dan paging in de gebruikersinterface. Alleen het ObjectDataSourceView object ondersteunt paginering van gegevensbronnen zonder wijzigingen.

Als u de wisselfunctie wilt inschakelen, stelt u de AllowPaging eigenschap in op true. U kunt het totale aantal items in de onderliggende gegevensbron bepalen met behulp van de PageCount eigenschap. Gebruik de PageIndex eigenschap om de index van het momenteel weergegeven item te bepalen.

Wanneer pagineering is ingeschakeld, wordt automatisch een extra rij met de naam van de pagerrij weergegeven in het DetailsView besturingselement. De paginarij bevat de besturingselementen voor paginanavigatie en kan worden weergegeven aan de boven-, onder- of onderkant van het besturingselement. De paginarij heeft twee ingebouwde weergavemodi voor pagina's: genummerde pagina's en koppelingen naar volgende en vorige pagina (standaard). In de modus genummerde pagina's worden koppelingen voor de afzonderlijke pagina's weergegeven, zodat de gebruiker naar een specifieke pagina kan navigeren. In de volgende en vorige koppelingsmodus worden besturingselementen weergegeven waarmee de gebruiker naar de volgende of de vorige pagina kan navigeren.

Note

Het DetailsView besturingselement verbergt automatisch de pagerrij wanneer de gegevensbron minder dan twee records bevat.

U kunt de instellingen van de paginarij (zoals de weergavemodus van de pager, het aantal paginakoppelingen dat tegelijk moet worden weergegeven en het tekstlabel van het pagerbesturingselement) beheren met behulp van de PagerSettings eigenschap. Gebruik de PagerStyle eigenschap om het uiterlijk van de paginarij te bepalen (inclusief de achtergrondkleur, tekstkleur en positie). DetailsView Met het besturingselement kunt u ook een aangepaste sjabloon definiëren voor de paginarij. Zie voor meer informatie over het maken van een aangepaste pagerrijsjabloon PagerTemplate.

Het DetailsView besturingselement biedt verschillende gebeurtenissen die u kunt gebruiken om een aangepaste actie uit te voeren wanneer paging plaatsvindt. De volgende tabel bevat de beschikbare gebeurtenissen.

Gebeurtenis Beschrijving
PageIndexChanged Treedt op wanneer op een van de paginaknoppen wordt geklikt, maar nadat het DetailsView besturingselement de wisselbewerking heeft verwerkt. Deze gebeurtenis wordt vaak gebruikt wanneer u een taak moet uitvoeren nadat de gebruiker naar een andere record in het besturingselement navigeert.
PageIndexChanging Treedt op wanneer op een van de paginaknoppen wordt geklikt, maar voordat het DetailsView besturingselement de wisselbewerking afhandelt. Deze gebeurtenis wordt vaak gebruikt om het pagina-bewerkingsproces te annuleren.

De waarde van AllowPaging wordt opgeslagen in de weergavestatus.

Van toepassing op

Zie ook