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

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

Примечание

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

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

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