PagerSettings Класс

Ссылка

Определение

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

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

Важно!

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

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

public ref class PagerSettings sealed : System::Web::UI::IStateManager

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager

Public NotInheritable Class PagerSettings
Implements IStateManager

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

Атрибуты: TypeConverterAttribute

Реализации: IStateManager

Примеры

В следующем примере кода показано, как использовать PagerSettings объект, содержащийся в PagerSettings свойстве, для настройки текста кнопок, отображаемых в строке пейджера GridView элемента управления.


<%@ 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 элементы управления), могут отображать набор элементов управления, называемых пейджером , который позволяет пользователю перемещаться по страницам в элементе управления. Класс PagerSettings используется этими элементами управления для представления свойств пейджера. Как правило, PagerSettings объект хранится в PagerSettings свойстве элемента управления. Вы можете настроить пейджер, задав свойства PagerSettings объекта.

Пейджер поддерживает несколько различных режимов отображения. Чтобы указать режим отображения пейджера, задайте Mode свойство. В следующей таблице описаны различные режимы.

Режим	Описание
NextPrevious	Кнопки "Предыдущая страница" и "Следующая страница".
NextPreviousFirstLast	Кнопки предыдущей страницы, следующей страницы, первой страницы и последней страницы.
Numeric	Нумерованные кнопки ссылок для прямого доступа к страницам.
NumericFirstLast	Нумерованная ссылка, первая ссылка и кнопки последней ссылки.

Mode Если свойству NextPreviousприсвоено значение или NextPreviousFirstLastзначение, NumericFirstLast можно настроить текст нечисловых кнопок, задав свойства, показанные в следующей таблице.

Свойство	Описание:
FirstPageText	Текст для кнопки первой страницы.
PreviousPageText	Текст для кнопки предыдущей страницы.
NextPageText	Текст для кнопки следующей страницы.
LastPageText	Текст для кнопки последней страницы.

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

Свойство	Описание:
FirstPageImageUrl	URL-адрес изображения для кнопки первой страницы.
PreviousPageImageUrl	URL-адрес изображения для кнопки предыдущей страницы.
NextPageImageUrl	URL-адрес изображения для кнопки следующей страницы.
LastPageImageUrl	URL-адрес изображения для кнопки последней страницы.

Примечание

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

Mode Если для свойства задано Numeric значение или NumericFirstLast значение, можно указать количество кнопок страницы для отображения в пейджере, задав PageButtonCount свойство.

Пейджер можно отобразить в верхней, нижней или нижней части элемента управления. Чтобы указать положение пейджера, задайте Position свойство. Чтобы отобразить или скрыть пейджер, используйте Visible свойство.

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

PagerSettings()

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

Свойства

FirstPageImageUrl	Получает или задает URL-адрес изображения для кнопки первой страницы.
FirstPageText	Получает или задает текст, отображаемый на кнопке первой страницы.
LastPageImageUrl	Получает или задает URL-адрес изображения для кнопки последней страницы.
LastPageText	Получает или задает текст, отображаемый на кнопке последней страницы.
Mode	Получает или задает режим отображения страничных навигаторов в элементе управления с поддержкой разбиения по страницам.
NextPageImageUrl	Получает или задает URL-адрес изображения для кнопки следующей страницы.
NextPageText	Получает или задает текст, отображаемый на кнопке следующей страницы.
PageButtonCount	Получает или задает число кнопок страниц, отображаемых в страничном навигаторе, если для свойства Mode задано значение Numeric или NumericFirstLast.
Position	Получает или задает значение, указывающее расположение страничного навигатора.
PreviousPageImageUrl	Получает или задает URL-адрес изображения для кнопки предыдущей страницы.
PreviousPageText	Получает или задает текст, отображаемый на кнопке предыдущей страницы.
Visible	Получает или задает значение, указывающее, отображаются ли страничные элементы управления в элементе управления с поддержкой разбиения по страницам.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Извлекает строковое представление объекта PagerSettings.

События

PropertyChanged

Происходит при изменении значений свойства объекта PagerSettings.

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

IStateManager.IsTrackingViewState	Возвращает значение, позволяющее определить, отслеживается ли изменение состояния представления серверного элемента управления.
IStateManager.LoadViewState(Object)	Загружает сохраненное ранее состояние представления объекта PagerSettings.
IStateManager.SaveViewState()	Сохраняет текущее состояние просмотра объекта PagerSettings.
IStateManager.TrackViewState()	Отмечает точку отсчета, с которой начинает отслеживание и сохранение изменений в состоянии представления объекта PagerSettings.

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