GridView.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 jeśli funkcja stronicowania jest włączona; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą AllowPaging właściwości deklaratywnie włączyć funkcję stronicowania w kontrolce GridView .


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Uwagi

Zamiast jednocześnie wyświetlać wszystkie rekordy w źródle danych, kontrolka GridView może automatycznie podzielić rekordy na strony. Jeśli źródło danych obsługuje funkcję stronicowania, GridView kontrolka może z tego skorzystać i zapewnić wbudowane funkcje stronicowania. Funkcja stronicowania może być używana z dowolnym obiektem źródła danych obsługującym System.Collections.ICollection interfejs lub źródło danych obsługujące możliwości stronicowania.

Aby włączyć funkcję stronicowania, ustaw AllowPaging właściwość na truewartość . Domyślnie kontrolka GridView wyświetla 10 rekordów na stronie jednocześnie. Liczbę rekordów wyświetlanych na stronie można zmienić, ustawiając PageSize właściwość . Aby określić łączną liczbę stron wymaganych do wyświetlenia zawartości źródła danych, użyj PageCount właściwości . Indeks aktualnie wyświetlanej strony można określić przy użyciu PageIndex właściwości .

Po włączeniu stronicowania w kontrolce jest automatycznie wyświetlany dodatkowy wiersz nazywany wierszem GridView pager. Wiersz pagera zawiera kontrolki, które umożliwiają użytkownikowi przechodzenie do innych stron. Za pomocą PagerSettings właściwości można kontrolować ustawienia wiersza stronicatora (np. tryb wyświetlania pager, liczbę łączy stron do wyświetlania w danym momencie i etykiety tekstowe kontrolki pagera). Wiersz pagera można wyświetlić w górnej, dolnej części lub w górnej i dolnej części kontrolki, ustawiając Position właściwość . Możesz również wybrać jeden z czterech wbudowanych trybów wyświetlania pager, ustawiając Mode właściwość . W poniższej tabeli opisano wbudowane tryby wyświetlania.

Tryb	Opis
`PagerButton.NextPrevious`	Zestaw kontrolek stronicowania składających się z poprzednich i następnych przycisków.
`PagerButton.NextPreviousFirstLast`	Zestaw kontrolek stronicowania składających się z poprzednich, następnych, pierwszych i ostatnich przycisków.
`PagerButton.Numeric`	Zestaw kontrolek stronicowania składających się z przycisków linków numerowanych w celu bezpośredniego uzyskiwania dostępu do stron. Jest to tryb domyślny.
`PagerButton.NumericFirstLast`	Zestaw kontrolek stronicowania składających się z numerowanych i pierwszych i ostatnich przycisków linku.

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 .

Uwaga

Kontrolka GridView automatycznie ukrywa wiersz pagera, gdy źródło danych zawiera tylko jedną stronę rekordów.

Kontrolka GridView 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 GridView 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 po kliknięciu jednego z przycisków pager, ale po kontrolce GridView obsługuje operację stronicowania. To zdarzenie jest często używane, gdy trzeba wykonać zadanie po przejściu użytkownika do innej strony w kontrolce.
PageIndexChanging	Występuje po kliknięciu jednego z przycisków stronicowania, ale zanim GridView kontrolka obsłuży operację stronicowania. To zdarzenie jest często używane do anulowania operacji stronicowania.

Dotyczy