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)

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

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

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

Были ли сведения на этой странице полезными?

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