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, задав свойства , PreviousPageImageUrl, NextPageImageUrlи LastPageImageUrl .

Если свойству ButtonType присвоено значение ButtonType.Image, соответствующее свойство text выступает в качестве альтернативного текста для изображения. Например, текст, заданный свойством 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)

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

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