NextPreviousPagerField Класс

Определение

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

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

Важно!

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

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

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField

public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField

type NextPreviousPagerField = class
    inherit DataPagerField

Public Class NextPreviousPagerField
Inherits DataPagerField

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

DataPagerField
NextPreviousPagerField

Примеры

В следующем примере показано, как использовать NextPreviousPagerField объект для просмотра данных, отображаемых в элементе 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </Fields>
      </asp:DataPager>

      <!-- 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>

Класс NextPreviousPagerField представляет поле, отображающее элементы управления навигацией в элементе DataPager управления. Эти элементы управления навигацией можно использовать для страницы с помощью данных, отображаемых элементом управления, реализующим IPageableItemContainer интерфейс, например ListView элемент управления.

Класс NextPreviousPagerField предоставляет кнопки, позволяющие пользователям перемещаться по страницам данных на одну страницу за раз или переходить к первой или последней странице данных.

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

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

Объект можно скрыть NextPreviousPagerField в элементе DataPager управления, задав Visible для свойства значение false. Вы также можете скрыть отдельные кнопки (первая страница, предыдущая страница, кнопки следующей страницы и последней страницы), задав ShowFirstPageButtonдля параметра , ShowPreviousPageButton ShowNextPageButtonи ShowLastPageButton свойстваfalse.

Элемент NextPreviousPagerField управления позволяет указать пользовательский текст для каждой FirstPageTextкнопки с помощью свойств , PreviousPageText NextPageTextи LastPageText свойств.

ButtonType Если для свойства задано ButtonType.Imageзначение, необходимо указать URL-адрес изображения, отображаемого для кнопки. Изображения можно задать по отдельности для каждой кнопки, задав FirstPageImageUrl NextPageImageUrl PreviousPageImageUrlсвойства и LastPageImageUrl свойства.

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

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

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

Свойства

Имя	Описание
ButtonCssClass	Возвращает или задает каскадный класс таблицы стилей (CSS), используемый для отображения кнопок поля пейджера в браузере.
ButtonType	Возвращает или задает тип кнопки для отображения в поле пейджера.
DataPager	Возвращает ссылку на пейджер данных, DataPagerField с которым связан объект. (Унаследовано от DataPagerField)
FirstPageImageUrl	Возвращает или задает URL-адрес изображения, отображаемого для кнопки первой страницы.
FirstPageText	Возвращает или задает текст, отображаемый для кнопки первой страницы.
IsTrackingViewState	Возвращает значение, указывающее, отслеживает ли DataPagerField объект изменения состояния представления. (Унаследовано от DataPagerField)
LastPageImageUrl	Возвращает или задает URL-адрес изображения, отображаемого для кнопки последней страницы в объекте NextPreviousPagerField .
LastPageText	Возвращает или задает текст, отображаемый для кнопки последней страницы.
NextPageImageUrl	Возвращает или задает URL-адрес изображения, отображаемого для кнопки следующей страницы в объекте NextPreviousPagerField .
NextPageText	Возвращает или задает текст, отображаемый для кнопки следующей страницы.
PreviousPageImageUrl	Возвращает или задает URL-адрес изображения, отображаемого для кнопки предыдущей страницы в объекте NextPreviousPagerField .
PreviousPageText	Возвращает или задает текст, отображаемый для кнопки предыдущей страницы.
QueryStringHandled	Возвращает или задает значение, указывающее, вычисляется ли поле строки запроса. (Унаследовано от DataPagerField)
QueryStringValue	Возвращает значение поля строки запроса из URL-адреса запроса. (Унаследовано от DataPagerField)
RenderDisabledButtonsAsLabels	Возвращает или задает значение, указывающее, отображаются ли отключенные кнопки в виде Label элементов управления NextPreviousPagerField объектом.
RenderNonBreakingSpacesBetweenControls	Возвращает или задает значение, указывающее, отображаются ли неразрывные пробелы между элементами управления.
ShowFirstPageButton	Возвращает или задает значение, указывающее, отображается ли кнопка первой страницы в объекте NextPreviousPagerField .
ShowLastPageButton	Возвращает или задает значение, указывающее, отображается ли кнопка последней страницы в объекте NextPreviousPagerField .
ShowNextPageButton	Возвращает или задает значение, указывающее, отображается ли в объекте кнопка следующей NextPreviousPagerField страницы.
ShowPreviousPageButton	Возвращает или задает значение, указывающее, отображается ли в объекте кнопка предыдущей NextPreviousPagerField страницы.
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние DataPagerField представления объекта в нескольких запросах на одну и ту же страницу. (Унаследовано от DataPagerField)
Visible	Возвращает или задает значение, указывающее, отображается ли поле пейджера данных. (Унаследовано от DataPagerField)

Методы

Имя	Описание
CloneField()	Создает копию текущего объекта, производного от DataPagerField. (Унаследовано от DataPagerField)
CopyProperties(DataPagerField)	Копирует свойства текущего NextPreviousPagerField объекта в указанный DataPagerField объект.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Создает элементы управления пользовательского интерфейса для объекта поля страницы и добавляет их в указанный контейнер.
CreateField()	Создает и возвращает новый экземпляр NextPreviousPagerField класса.
Equals(Object)	Определяет, равен ли указанный объект текущему NextPreviousPagerField объекту.
GetHashCode()	Служит хэш-функцией для класса NextPreviousPagerField.
GetQueryStringNavigateUrl(Int32)	Создает URL-адрес, содержащий поле строки запроса с указанным номером страницы. (Унаследовано от DataPagerField)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
HandleEvent(CommandEventArgs)	Обрабатывает события, происходящие в элементе NextPreviousPagerField управления, и выполняет соответствующее действие.
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)

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

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

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

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

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