Udostępnij za pośrednictwem


GridView.AllowPaging Właściwość

Definicja

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

Zobacz też