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	Предыдущая страница, следующая страница, первая страница и последние кнопки -page.
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 .

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

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