DetailsView.AllowPaging Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.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.

Pobiera lub ustawia wartość wskazującą, czy funkcja stronicowania jest włączona.

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

Wartość właściwości

Boolean

true aby włączyć funkcję stronicowania; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą AllowPaging właściwości włączyć możliwości stronicowania kontrolki DetailsView .

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

Uwagi

Kontrolka DetailsView ma wbudowane funkcje stronicowania, które umożliwiają użytkownikowi przechodzenie do innego rekordu w źródle danych.

Kontrolka DetailsView może wykonywać stronicowanie zarówno interfejsu użytkownika, jak i źródła danych. Funkcja stronicowania interfejsu użytkownika może być używana z dowolnym obiektem źródła danych obsługującym System.Collections.ICollection interfejs. Dla każdej operacji stronicowania kontrolka DetailsView wysyła zapytanie do źródła danych dla całej kolekcji danych i wybiera wiersz do wyświetlenia, zasadniczo odrzucając pozostałe dane.

Jeśli źródło danych zostanie zaimplementowane DataSourceView , a CanPage właściwość zwróci truewartość , DetailsView kontrolka będzie używać stronicowania źródła danych zamiast stronicowania interfejsu użytkownika. W takim przypadku kontrolka DetailsView będzie wykonywać zapytania dotyczące tylko wiersza wymaganego dla każdej operacji stronicowania. W związku z tym stronicowanie źródła danych jest bardziej wydajne niż stronicowanie interfejsu użytkownika. ObjectDataSourceView Tylko obiekt obsługuje stronicowanie źródła danych bez modyfikacji.

Aby włączyć funkcję stronicowania, ustaw AllowPaging właściwość na truewartość . Łączną liczbę elementów w bazowym źródle danych można określić za pomocą PageCount właściwości . Aby określić indeks aktualnie wyświetlanego elementu, użyj PageIndex właściwości .

Po włączeniu stronicowania w kontrolce jest automatycznie wyświetlany dodatkowy wiersz nazywany wierszem DetailsView pager. Wiersz pager zawiera kontrolki nawigacji strony i może być wyświetlany w górnej, dolnej części lub w górnej i dolnej części kontrolki. Wiersz pagera ma dwa wbudowane tryby wyświetlania pager: strony numerowane i następne i poprzednie linki strony (ustawienie domyślne). Tryb stron numerowanych wyświetla łącza dla poszczególnych stron, co pozwala użytkownikowi na przechodzenie do określonej strony. W następnym i poprzednim trybie łączy są wyświetlane kontrolki, które umożliwiają użytkownikowi przejście do następnej lub poprzedniej strony.

Uwaga

Kontrolka DetailsView automatycznie ukrywa wiersz pagera, gdy źródło danych zawiera mniej niż dwa rekordy.

Za pomocą właściwości można kontrolować ustawienia wiersza stronicatora (na przykład tryb wyświetlania pager, liczbę łączy stron do wyświetlenia w danym momencie i etykietę tekstową PagerSettings kontrolki pager). Aby kontrolować wygląd wiersza pagera (w tym jego kolor tła, kolor czcionki i położenie), użyj PagerStyle właściwości . Kontrolka DetailsView umożliwia również zdefiniowanie szablonu niestandardowego dla wiersza pagera. Aby uzyskać więcej informacji na temat tworzenia niestandardowego szablonu wiersza stronicowania, zobacz PagerTemplate.

Kontrolka DetailsView udostępnia kilka zdarzeń, których można użyć do wykonania akcji niestandardowej podczas stronicowania. W poniższej tabeli wymieniono dostępne zdarzenia.

Zdarzenie	Opis
PageIndexChanged	Występuje, gdy jeden z przycisków pager jest klikany, ale po kontrolce DetailsView obsługuje operację stronicowania. To zdarzenie jest często używane, gdy trzeba wykonać zadanie po przejściu użytkownika do innego rekordu w kontrolce.
PageIndexChanging	Występuje po kliknięciu jednego z przycisków stronicowania, ale zanim DetailsView kontrolka obsłuży operację stronicowania. To zdarzenie jest często używane do anulowania operacji stronicowania.

Wartość jest AllowPaging przechowywana w stanie widoku.

Dotyczy