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)

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