NumericPagerField Класс

Определение

Представляет поле DataPager, которое предоставляет пользователям возможность выбрать страницу по номеру.

public ref class NumericPagerField : System::Web::UI::WebControls::DataPagerField
public class NumericPagerField : System.Web.UI.WebControls.DataPagerField
type NumericPagerField = class
    inherit DataPagerField
Public Class NumericPagerField
Inherits DataPagerField
Наследование
NumericPagerField

Примеры

В следующем примере показано, как использовать NumericPagerField объект для перестраивать данные, отображаемые в элементе ListView управления .

<%@ 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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </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 id="Head1" runat="server">
    <title>NumericPagerField Example</title>    
    <style type="text/css">
      body 	
      {
        text-align: center;
        font: 12px Arial, Helvetica, sans-serif;
      } 
      table
      {
        padding: 2px 2px 2px 2px;
        border: 1px solid;
        width: 500px;
      }     
      .CurrentPage 
      {
        padding: 2px 6px;
        border: solid 1px #ddd; 
        background: #2E8B57;
        color:White;
      }
      .PrevNext,.PageNumber
      {
        padding: 2px 6px;
        border: solid 1px #ddd;
        text-decoration: none;
        color: #2E8B57;
      }
      .PageNumber:hover, .PrevNext:hover
      {
        background-color: #FFA500;
        color: White;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NumericPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td align="left">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("LastName") & ", " & Eval("FirstName")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <div>
        <asp:DataPager runat="server" 
          ID="ContactsDataPager" 
          PagedControlID="ContactsListView">
          <Fields>
            <asp:NumericPagerField 
              PreviousPageText="< Prev"
              NextPageText="Next >"
              ButtonCount="10"
              NextPreviousButtonCssClass="PrevNext"
              CurrentPageLabelCssClass="CurrentPage"
              NumericButtonCssClass="PageNumber" />
          </Fields>
        </asp:DataPager>
      </div>
      <br />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Комментарии

Класс NumericPagerField отображает элементы управления навигацией в элементе DataPager управления . Элементы управления можно использовать для перекачки данных, отображаемых элементом управления, реализующим IPageableItemContainer интерфейс, например элементом ListView управления . Объект NumericPagerField отображает номера страниц в виде кнопок, которые пользователи могут нажать для перемещения на определенную страницу. В элементе управления также отображаются кнопки "Следующая страница" и "Предыдущая страница", которые позволяют пользователям получать доступ к большему количествам страниц данных, чем те, которые отображаются элементом управления.

Внешний NumericPagerField вид объекта можно настроить с помощью свойств, перечисленных в следующей таблице.

Свойство. Описание
CurrentPageLabelCssClass Класс CSS для текущего номера страницы.
NextPreviousButtonCssClass Класс CSS для кнопок следующей и предыдущей страницы.
NumericButtonCssClass Класс CSS для кнопок, представляющих номера страниц.

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

Тип кнопки Описание
ButtonType.Button Элемент управления Button.
ButtonType.Image Элемент управления ImageButton.
ButtonType.Link Элемент управления LinkButton.

Элементы управления внутри NumericButtonCssClass объекта отображаются с неразрывными пробелами между ними. Если вы хотите настроить это поведение, можно использовать RenderNonBreakingSpacesBetweenControls свойство .

Вы можете скрыть NumericPagerField объект в элементе управления , DataPager задав свойству Visible значение false. Невозможно управлять видимостью кнопок следующей и предыдущей страницы. Они отображаются элементом управления , если связанный элемент управления данными содержит дополнительные доступные для отображения страницы. Свойство можно использовать для ButtonCount указания количества кнопок, отображаемых в объекте NumericPagerField . Каждая кнопка соответствует номеру страницы.

Вы можете задать текст кнопки следующей страницы, задав NextPageText свойство . Вы можете задать текст кнопки предыдущей страницы с помощью PreviousPageText свойства .

Если свойству ButtonType присвоено значение ButtonType.Image, необходимо указать URL-адрес изображения, которое будет отображаться для кнопок следующей и предыдущей страницы. Это можно сделать, задав NextPageImageUrl свойства и PreviousPageImageUrl . В этом случае соответствующее свойство текста используется в качестве альтернативного текста для изображения. Например, текст, заданный свойством NextPageImageUrl , отображается в качестве альтернативного текста для кнопки изображения следующей страницы. В браузерах, поддерживающих подсказки, этот текст также отображается в виде подсказки для соответствующей кнопки.

Конструкторы

NumericPagerField()

Инициализирует новый экземпляр класса NumericPagerField.

Свойства

ButtonCount

Возвращает или задает число кнопок, отображаемых в объекте NumericPagerField.

ButtonType

Возвращает или задает тип кнопки, отображаемой в строке страницы.

CurrentPageLabelCssClass

Возвращает или задает класс каскадных таблиц стилей (CSS), используемых для применения стиля к номеру текущей страницы.

DataPager

Возвращает ссылку на страничный навигатор, с которым он связан объект DataPagerField.

(Унаследовано от DataPagerField)
IsTrackingViewState

Получает значение, позволяющее определить, отслеживает ли объект DataPagerField изменения в своем состоянии представления.

(Унаследовано от DataPagerField)
NextPageImageUrl

Возвращает или задает URL-адрес изображения, отображаемого для кнопки следующей страницы в объекте NumericPagerField.

NextPageText

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

NextPreviousButtonCssClass

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

NumericButtonCssClass

Возвращает или задает класс каскадных таблиц стилей (CSS), используемый для применения стиля к кнопкам номеров страниц в поле страничного навигатора.

PreviousPageImageUrl

Возвращает или задает URL-адрес изображения, отображаемого для кнопки предыдущей страницы в объекте NumericPagerField.

PreviousPageText

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

QueryStringHandled

Возвращает или задает значение, позволяющее определить, было ли оценено поле строки запроса.

(Унаследовано от DataPagerField)
QueryStringValue

Получает значение поля строки запроса, извлеченное из его URL-адреса.

(Унаследовано от DataPagerField)
RenderNonBreakingSpacesBetweenControls

Возвращает или задает значение, позволяющее определить, будут ли обрабатываться неразрывные пробелы между элементами управления.

ViewState

Возвращает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние объекта DataPagerField для нескольких запросов одной и той же страницы.

(Унаследовано от DataPagerField)
Visible

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

(Унаследовано от DataPagerField)

Методы

CloneField()

Создает копию текущего объекта, производного от объекта DataPagerField.

(Унаследовано от DataPagerField)
CopyProperties(DataPagerField)

Копирует свойства текущего объекта NumericPagerField в указанный объект DataPagerField.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Создает элемент управления пользовательского интерфейса для объекта поля страничного навигатора и добавляет его в указанный контейнер.

CreateField()

Создает и возвращает новый экземпляр класса NumericPagerField.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту NumericPagerField.

GetHashCode()

Служит хэш-функцией для класса NumericPagerField.

GetQueryStringNavigateUrl(Int32)

Создает URL-адрес, содержащий поле строки запроса, для которого задан номер страницы.

(Унаследовано от DataPagerField)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
HandleEvent(CommandEventArgs)

Обрабатывает события, происходящие в объекте NumericPagerField, и выполняет соответствующие действия.

LoadViewState(Object)

Восстанавливает сохраненные ранее сведения о состоянии представления.

(Унаследовано от DataPagerField)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnFieldChanged()

Вызывает событие FieldChanged.

(Унаследовано от DataPagerField)
SaveViewState()

Сохраняет изменения, внесенные в состояние представления объекта DataPagerField.

(Унаследовано от DataPagerField)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TrackViewState()

Инициирует отслеживание объектом DataPagerField изменений в состоянии его представления с целью сохранения их в свойстве элемента управления ViewState и обеспечения их неизменности в различных запросах одной и той же страницы.

(Унаследовано от DataPagerField)

Явные реализации интерфейса

IStateManager.IsTrackingViewState

Получает значение, позволяющее определить, отслеживает ли объект DataPagerField изменения в своем состоянии представления.

(Унаследовано от DataPagerField)
IStateManager.LoadViewState(Object)

Восстанавливает сохраненные ранее сведения о состоянии представления.

(Унаследовано от DataPagerField)
IStateManager.SaveViewState()

Сохраняет изменения, внесенные в состояние представления объекта DataPagerField.

(Унаследовано от DataPagerField)
IStateManager.TrackViewState()

Инициирует отслеживание объектом DataPagerField изменений в состоянии его представления с целью сохранения их в свойстве элемента управления ViewState и обеспечения их неизменности в различных запросах одной и той же страницы.

(Унаследовано от DataPagerField)

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

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