FormView.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 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

Udostępnij za pośrednictwem