DetailsView.AllowPaging Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om växlingsfunktionen är aktiverad.

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

Egenskapsvärde

Boolean

trueför att aktivera växlingsfunktionen. annars . false Standardvärdet är false.

Exempel

I följande kodexempel visas hur du använder AllowPaging egenskapen för att aktivera växlingsfunktionerna i DetailsView kontrollen.

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

Kommentarer

Kontrollen DetailsView har inbyggda växlingsfunktioner som gör att en användare kan navigera till en annan post i datakällan.

Kontrollen DetailsView kan utföra både användargränssnitt (UI) och datakällans växling. UI-växlingsfunktionen kan användas med alla datakällans objekt som stöder System.Collections.ICollection gränssnittet. För varje växlingsåtgärd DetailsView frågar kontrollen datakällan för hela datainsamlingen och väljer den rad som ska visas, vilket i princip tar bort återstående data.

Om en datakälla implementerar DataSourceView och CanPage egenskapen returnerar trueDetailsView använder kontrollen datakällans växling i stället för UI-växling. I det här fallet DetailsView frågar kontrollen bara efter den rad som behövs för varje växlingsåtgärd. Därför är datakällans växling effektivare än UI-växling. ObjectDataSourceView Endast objektet stöder datakällans växling utan ändringar.

Om du vill aktivera växlingsfunktionen anger du AllowPaging egenskapen till true. Du kan fastställa det totala antalet objekt i den underliggande datakällan med hjälp PageCount av egenskapen . Om du vill fastställa indexet för det objekt som visas använder du egenskapen PageIndex .

När växling är aktiverat visas en ytterligare rad med namnet pager-raden automatiskt i DetailsView kontrollen. Pager-raden innehåller sidnavigeringskontrollerna och kan visas överst, längst ned eller både överst och längst ned i kontrollen. Pager-raden har två inbyggda sidvisningslägen: numrerade sidor och länkar till nästa och föregående sida (standard). Läget numrerade sidor visar länkar för de enskilda sidorna, så att användaren kan navigera till en viss sida. I nästa och föregående länkläge visas kontroller som gör att användaren kan navigera till nästa eller föregående sida.

Note

Kontrollen DetailsView döljer automatiskt pager-raden när datakällan innehåller färre än två poster.

Du kan styra inställningarna för sidsidesraden (till exempel sidvisningsläget, antalet sidlänkar som ska visas i taget och sidkontrollens textetikett) med hjälp PagerSettings av egenskapen . Om du vill styra utseendet på sidsökarraden (inklusive dess bakgrundsfärg, teckenfärg och position) använder du PagerStyle egenskapen . Med DetailsView kontrollen kan du också definiera en anpassad mall för pager-raden. Mer information om hur du skapar en anpassad sidradsmall finns i PagerTemplate.

Kontrollen DetailsView innehåller flera händelser som du kan använda för att utföra en anpassad åtgärd vid växling. I följande tabell visas tillgängliga händelser.

Händelse Description
PageIndexChanged Inträffar när en av sidsidesknapparna klickas, men när DetailsView kontrollen har hanterat växlingsåtgärden. Den här händelsen används ofta när du behöver utföra en uppgift när användaren har navigerat till en annan post i kontrollen.
PageIndexChanging Inträffar när en av sidsidesknapparna klickas, men innan DetailsView kontrollen hanterar växlingsåtgärden. Den här händelsen används ofta för att avbryta växlingsåtgärden.

Värdet för AllowPaging lagras i visningstillstånd.

Gäller för

Se även