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

GridView.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

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

Примеры

В следующем примере показано, как использовать AllowPaging свойство для декларативного включения функции разбиения по страницам в элементе GridView управления.


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Комментарии

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

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

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

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

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

Замечание

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

Элемент GridView управления также позволяет определить пользовательский шаблон для строки пейджера. Дополнительные сведения о создании пользовательского шаблона строки пейджера см. в статье PagerTemplate.

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

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

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

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