NumericPagerField Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.Extensions.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет поле 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

Наследование: Object

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)

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

NumericPagerField Класс

Определение

Примеры

Комментарии

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

Свойства

Методы

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

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

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

Обратная связь

Дополнительные ресурсы