Поделиться через

FormView.AllowPaging Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает значение, указывающее, включена ли функция разбиения по страницам.

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

Значение свойства

Boolean

true для включения функции разбиения по страницам; falseв противном случае . Значение по умолчанию — false.

Примеры

В следующем примере показано, как использовать AllowPaging свойство для включения функции разбиения по страницам в 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>

Комментарии

Элемент FormView управления имеет встроенные возможности разбиения на страницы, которые позволяют пользователю переходить к другой записи в источнике данных. Функцию разбиения по страницам можно использовать с любым объектом источника данных, поддерживающим System.Collections.ICollection интерфейс или источник данных, поддерживающий возможности разбиения по страницам.

Чтобы включить функцию разбиения по страницам, задайте AllowPaging для свойства значение true. Общее количество элементов в базовом источнике данных можно определить с помощью PageCount свойства. Чтобы определить индекс отображаемого в данный момент элемента, используйте PageIndex свойство.

При включении разбиения на страницы в элементе управления автоматически отображается дополнительная строка, называемая строкой пейджера FormView . Строка пейджера содержит элементы управления навигацией страницы и может отображаться в верхней, нижней или нижней части элемента управления. Строка пейджера имеет четыре встроенных режима отображения пейджера. В следующей таблице описаны четыре режима.

Режим Описание
PagerButton.NextPrevious Набор элементов управления разбивкой на страницы, состоящий из предыдущих и следующих кнопок.
PagerButton.NextPreviousFirstLast Набор элементов управления разбивкой на страницы, состоящий из предыдущих, следующих, первых и последних кнопок.
PagerButton.Numeric Набор элементов управления разбивкой на страницы, состоящий из нумерованных кнопок ссылок для прямого доступа к страницам. Это режим по умолчанию.
PagerButton.NumericFirstLast Набор элементов управления разбивкой на страницы, состоящий из нумерованных и последних кнопок ссылок.

Замечание

Элемент FormView управления автоматически скрывает строку пейджера, если источник данных содержит менее двух записей.

Вы можете управлять параметрами строки пейджера (например, режимом отображения пейджера, числом ссылок страниц, отображаемыми за раз, и текстовой меткой элемента управления пейджера) с помощью PagerSettings свойства. Чтобы управлять внешним видом строки пейджера (включая цвет фона и цвет шрифта), используйте PagerStyle это свойство. Элемент FormView управления также позволяет определить пользовательский шаблон для строки пейджера. Дополнительные сведения о создании пользовательского шаблона строки пейджера см. в статье PagerTemplate.

Элемент FormView управления предоставляет несколько событий, которые можно использовать для выполнения пользовательского действия при выполнении разбиения по страницам. В следующей таблице перечислены доступные события.

Event Описание
PageIndexChanged Происходит при нажатии одной из кнопок пейджера, но после FormView того, как элемент управления обрабатывает операцию разбиения по страницам. Это событие обычно используется, когда необходимо выполнить задачу после перехода пользователя к другой записи в элементе управления.
PageIndexChanging Происходит при нажатии одной из кнопок пейджера, но перед тем, как FormView элемент управления обрабатывает операцию разбиения по страницам. Это событие часто используется для отмены операции разбиения по страницам.

Замечание

Эти события не возникают при программном PageIndex изменении свойства.

Применяется к

См. также раздел