NextPreviousPagerField Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет поле, отображающее навигационные элементы управления в элементе управления 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
- Наследование
Примеры
В следующем примере показано, как использовать 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, ShowPreviousPageButtonShowNextPageButtonи ShowLastPageButton свойства false
.
Элемент NextPreviousPagerField управления позволяет указать пользовательский текст для каждой кнопки с помощью FirstPageTextPreviousPageTextсвойств , NextPageTextи LastPageText свойств.
ButtonType Если для свойства задано значениеButtonType.Image
, необходимо указать URL-адрес изображения, которое будет отображаться для кнопки. Вы можете задать изображения по отдельности для каждой кнопки, задав FirstPageImageUrlNextPageImageUrlPreviousPageImageUrlсвойства и 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() |
Вызывает событие |
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) |