DetailsView.AllowPaging Свойство

Определение

Возвращает или задает значение, определяющее, доступна ли возможность разбиения по страницам.Gets or sets a value indicating whether the paging feature is enabled.

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.true to enable the paging feature; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере кода показано, как использовать AllowPaging свойство для включения возможности разбиения по страницам DetailsView элемента управления.The following code example demonstrates how to use the AllowPaging property to enable the paging capabilities of the DetailsView control.

<%@ 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Элемент управления имеет встроенные возможности разбиения на страницы, которые позволяют пользователю переходить к другой записи в источнике данных.The DetailsView control has built-in paging capabilities, which allow a user to navigate to a different record in the data source.

DetailsViewЭлемент управления может выполнять как пользовательский интерфейс, так и разбиение по страницам источника данных.The DetailsView control can perform both user interface (UI) and data source paging. Функцию разбиения по страницам пользовательского интерфейса можно использовать с любым объектом источника данных, который поддерживает System.Collections.ICollection интерфейс.The UI paging feature can be used with any data source object that supports the System.Collections.ICollection interface. Для каждой операции разбиения на страницы DetailsView элемент управления запрашивает источник данных для всей коллекции данных и выбирает отображаемую строку, фактически удаляя оставшиеся данные.For each paging operation, the DetailsView control queries the data source for the entire data collection and selects the row to display, essentially discarding the remaining data.

Если источник данных реализует DataSourceView и CanPage свойство возвращает true , DetailsView элемент управления будет использовать разбиение на страницы источника данных вместо РАЗБИЕНИЯ на страницы пользовательского интерфейса.If a data source implements DataSourceView and the CanPage property returns true, the DetailsView control will use data source paging instead of UI paging. В этом случае DetailsView элемент управления будет запрашивать только строку, необходимую для каждой операции разбиения на страницы.In this case, the DetailsView control will query for only the row needed for each paging operation. Таким способом, разбиение по страницам источника данных более эффективно, чем разбиение на страницы пользовательского интерфейса.Thus, data source paging is more efficient than UI paging. Только ObjectDataSourceView объект поддерживает разбиение по страницам источника данных без изменения.Only the ObjectDataSourceView object supports data source paging without modification.

Чтобы включить функцию разбиения по страницам, задайте AllowPaging для свойства значение true .To enable the paging feature, set the AllowPaging property to true. Можно определить общее число элементов в базовом источнике данных с помощью PageCount Свойства.You can determine the total number of items in the underlying data source by using the PageCount property. Чтобы определить индекс отображаемого в данный момент элемента, используйте PageIndex свойство.To determine the index of the currently displayed item, use the PageIndex property.

Если разбиение по страницам включено, в элементе управления автоматически отображается дополнительная строка, называемая строкой страничного навигатора DetailsView .When paging is enabled, an additional row called the pager row is automatically displayed in the DetailsView control. Строка страничного навигатора содержит элементы управления навигацией по страницам и может отображаться в верхней, нижней части или в верхней и нижней части элемента управления.The pager row contains the page navigation controls and can be displayed at the top, bottom, or both the top and bottom of the control. Строка страничного навигатора имеет два встроенных режима экрана: нумерованные страницы и ссылки на следующие и предыдущие страницы (по умолчанию).The pager row has two built-in pager display modes: numbered pages and next and previous page links (default). Режим нумерованных страниц отображает ссылки на отдельные страницы, позволяя пользователю переходить на определенную страницу.The numbered pages mode displays links for the individual pages, allowing the user to navigate to a specific page. В режиме Next и Previous Links отображаются элементы управления, позволяющие пользователю переходить к следующей или предыдущей странице.The next and previous links mode displays controls that allow the user to navigate to the next or the previous page.

Примечание

DetailsViewЭлемент управления автоматически скрывает строку страничного навигатора, если источник данных содержит менее двух записей.The DetailsView control automatically hides the pager row when the data source contains fewer than two records.

С помощью свойства можно управлять параметрами строки страничного навигатора (например, режимом просмотра страничного навигатора, количеством отображаемых ссылок страницы и текстовой меткой элемента управления страничного навигатора) PagerSettings .You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text label) by using the PagerSettings property. Чтобы управлять внешним видом строки страничного навигатора (включая цвет фона, цвет и расположение шрифта), используйте PagerStyle свойство.To control the appearance of the pager row (including its background color, font color, and position), use the PagerStyle property. DetailsViewЭлемент управления также позволяет определить пользовательский шаблон для строки страничного навигатора.The DetailsView control also allows you to define a custom template for the pager row. Дополнительные сведения о создании пользовательского шаблона строк страничного навигатора см. в разделе PagerTemplate .For more information on creating a custom pager row template, see PagerTemplate.

DetailsViewЭлемент управления предоставляет несколько событий, которые можно использовать для выполнения настраиваемых действий при разбиении на страницы.The DetailsView control provides several events that you can use to perform a custom action when paging occurs. В следующей таблице перечислены доступные события.The following table lists the available events.

СобытиеEvent ОписаниеDescription
PageIndexChanged Происходит при щелчке кнопки страницы, но после обработки операции разбиения по страницам элементом управления DetailsView.Occurs when one of the pager buttons is clicked, but after the DetailsView control handles the paging operation. Это событие часто используется, когда необходимо выполнить задачу после перехода пользователя к другой записи в элементе управления.This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
PageIndexChanging Происходит при щелчке кнопки страницы, но перед обработкой операции разбиения по страницам элементом управления DetailsView.Occurs when one of the pager buttons is clicked, but before the DetailsView control handles the paging operation. Это событие часто используется для отмены операции разбиения на страницы.This event is often used to cancel the paging operation.

Значение хранится AllowPaging в состоянии представления.The value of AllowPaging is stored in view state.

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

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