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

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

<%@ 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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Комментарии

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

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

Если источник данных реализует DataSourceView и CanPage возвращает trueсвойство, DetailsView элемент управления будет использовать разбиение на страницы источника данных вместо разбиения на страницы пользовательского интерфейса. В этом случае DetailsView элемент управления запрашивает только строку, необходимую для каждой операции разбиения по страницам. Таким образом, разбиение по страницам источника данных более эффективно, чем разбиение по страницам пользовательского интерфейса. ObjectDataSourceView Только объект поддерживает разбиение по страницам источника данных без изменения.

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

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

Замечание

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

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

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

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

Значение AllowPaging хранится в состоянии представления.

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

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