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

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

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

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

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