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

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

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

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

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