PagerSettings Класс

Определение

Представляет свойства элементов управления переходами между страницами в элементе управления, поддерживающем разбиение на страницы.Represents the properties of the paging controls in a control that supports pagination. Этот класс не наследуется.This class cannot be inherited.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
Наследование
PagerSettings
Атрибуты
Реализации

Примеры

В следующем примере кода показано, как использовать PagerSettings объект, содержащийся PagerSettings в свойстве, для настройки текста кнопок, отображаемых в строке GridView страничного навигатора элемента управления.The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a GridView control.


<%@ 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Комментарии

Элементы управления, поддерживающие разбиение на GridViewстраницы DetailsView(например FormView , элементы управления, и), могут отображать набор элементов управления, называемый страничным навигатором , который позволяет пользователю перемещаться по страницам внутри элемента управления.Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. PagerSettings Класс используется этими элементами управления для представления свойств пейджера.The PagerSettings class is used by these controls to represent the properties of the pager. Как правило, PagerSettings объект хранится PagerSettings в свойстве элемента управления.In general, the PagerSettings object is stored in the PagerSettings property of the control. Можно настроить страничный навигатор, задав свойства PagerSettings объекта.You can customize the pager by setting the properties of the PagerSettings object.

Страничный навигатор поддерживает несколько различных режимов экрана.The pager supports several different display modes. Чтобы указать режим, в котором будет отображаться страничный навигатор, задайте Mode свойство.To specify the mode in which to display the pager, set the Mode property. В следующей таблице описаны различные режимы.The following table describes the different modes.

РежимMode ОписаниеDescription
NextPrevious Кнопки «Предыдущая страница» и «Следующая страница».Previous-page and next-page buttons.
NextPreviousFirstLast Кнопки «Предыдущая страница», «Следующая страница», «первая страница» и «последняя страница».Previous-page, next-page, first-page, and last -page buttons.
Numeric Кнопки нумерованных ссылок для прямого доступа к страницам.Numbered link buttons to access pages directly.
NumericFirstLast Кнопки нумерованный-Link, First-Link и Last-Link.Numbered-link, first-link, and last-link buttons.

Если для свойства задано NumericFirstLast значение NextPreviousFirstLast, или, можно настроить текст нечисловых кнопок, задав свойства, показанные в следующей таблице. NextPrevious ModeWhen the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table.

Свойство.Property ОписаниеDescription
FirstPageText Текст для кнопки первой страницы.Text for the first-page button.
PreviousPageText Текст для кнопки предыдущей страницы.Text for the previous-page button.
NextPageText Текст для кнопки следующей страницы.Text for the next-page button.
LastPageText Текст для кнопки последней страницы.Text for the last-page button.

В качестве альтернативы можно также отображать изображения для нечисловых кнопок, задав свойства, как показано в следующей таблице.As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table.

Свойство.Property ОписаниеDescription
FirstPageImageUrl URL-адрес изображения для кнопки первой страницы.The URL to an image to display for the first-page button.
PreviousPageImageUrl URL-адрес изображения для кнопки предыдущей страницы.The URL to an image to display for the previous-page button.
NextPageImageUrl URL-адрес изображения для кнопки следующей страницы.The URL to an image to display for the next-page button.
LastPageImageUrl URL-адрес изображения для кнопки последней страницы.The URL to an image to display for the last-page button.

Примечание

Если задано свойство Image, соответствующее свойство Text выступает в качестве альтернативного текста для изображения.When an image property is set, the corresponding text property acts as the alternate text for the image. Например, если FirstPageImageUrl свойство задано, текст, заданный FirstPageText свойством, отображается в качестве альтернативного текста для изображения.For example, when the FirstPageImageUrl property is set, the text that is specified by the FirstPageText property is displayed as the alternate text for the image. В браузерах, поддерживающих подсказки, этот текст также отображается в виде подсказки для соответствующей кнопки.On browsers that support ToolTips, this text is also displayed as a ToolTip for the corresponding button.

Если для свойства задано PageButtonCount значение NumericFirstLast или, можно указать число кнопок страницы, отображаемых на пейджере, задав свойство. Numeric ModeWhen the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property.

Страничный навигатор может отображаться вверху, внизу или в верхней и нижней части элемента управления.The pager can be displayed at the top, the bottom, or both the top and bottom of a control. Чтобы указать расположение пейджера, задайте Position свойство.To specify the position of the pager, set the Position property. Чтобы показать или скрыть страничный навигатор, используйте Visible свойство.To show or hide the pager, use the Visible property.

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

PagerSettings()

Инициализирует новый экземпляр класса PagerSettings.Initializes a new instance of the PagerSettings class.

Свойства

FirstPageImageUrl

Получает или задает URL-адрес изображения для кнопки первой страницы.Gets or sets the URL to an image to display for the first-page button.

FirstPageText

Получает или задает текст, отображаемый на кнопке первой страницы.Gets or sets the text to display for the first-page button.

LastPageImageUrl

Получает или задает URL-адрес изображения для кнопки последней страницы.Gets or sets the URL to an image to display for the last-page button.

LastPageText

Получает или задает текст, отображаемый на кнопке последней страницы.Gets or sets the text to display for the last-page button.

Mode

Получает или задает режим отображения страничных навигаторов в элементе управления с поддержкой разбиения по страницам.Gets or sets the mode in which to display the pager controls in a control that supports pagination.

NextPageImageUrl

Получает или задает URL-адрес изображения для кнопки следующей страницы.Gets or sets the URL to an image to display for the next-page button.

NextPageText

Получает или задает текст, отображаемый на кнопке следующей страницы.Gets or sets the text to display for the next-page button.

PageButtonCount

Получает или задает число кнопок страниц, отображаемых в страничном навигаторе, если для свойства Mode задано значение Numeric или NumericFirstLast.Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.

Position

Получает или задает значение, указывающее расположение страничного навигатора.Gets or sets a value that specifies the location where the pager is displayed.

PreviousPageImageUrl

Получает или задает URL-адрес изображения для кнопки предыдущей страницы.Gets or sets the URL to an image to display for the previous-page button.

PreviousPageText

Получает или задает текст, отображаемый на кнопке предыдущей страницы.Gets or sets the text to display for the previous page button.

Visible

Получает или задает значение, указывающее, отображаются ли страничные элементы управления в элементе управления с поддержкой разбиения по страницам.Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Извлекает строковое представление объекта PagerSettings.Retrieves the string representation of a PagerSettings object.

События

PropertyChanged

Происходит при изменении значений свойства объекта PagerSettings.Occurs when a property of a PagerSettings object changes values.

Явные реализации интерфейса

IStateManager.IsTrackingViewState

Возвращает значение, позволяющее определить, отслеживается ли изменение состояния представления серверного элемента управления.Gets a value that indicates whether the server control is tracking its view state changes.

IStateManager.LoadViewState(Object)

Загружает сохраненное ранее состояние представления объекта PagerSettings.Loads the previously saved view state of the PagerSettings object.

IStateManager.SaveViewState()

Сохраняет текущее состояние просмотра объекта PagerSettings.Saves the current view state of the PagerSettings object.

IStateManager.TrackViewState()

Отмечает точку отсчета, с которой начинает отслеживание и сохранение изменений в состоянии представления объекта PagerSettings.Marks the starting point at which to begin tracking and saving view state changes to the PagerSettings object.

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

Дополнительно