FormView.AllowPaging Właściwość

  • Odwołanie

Definicja

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

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 pokazano, jak za pomocą AllowPaging właściwości włączyć funkcję stronicowania w kontrolce FormView .


<%@ 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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Uwagi

Kontrolka FormView ma wbudowane funkcje stronicowania, które umożliwiają użytkownikowi przechodzenie do innego rekordu w źródle danych. 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ść . Łą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 FormView 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 cztery wbudowane tryby wyświetlania pager. W poniższej tabeli opisano cztery tryby.

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.

Uwaga

Kontrolka FormView 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 pager (w tym jego kolor tła i kolor czcionki), użyj PagerStyle właściwości . Kontrolka FormView 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 FormView 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 FormView 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 FormView kontrolka obsłuży operację stronicowania. To zdarzenie jest często używane do anulowania operacji stronicowania.

Uwaga

Te zdarzenia nie są wywoływane podczas programowego zmieniania PageIndex właściwości.

Dotyczy

Zobacz też