DataPagerField DataPagerField DataPagerField DataPagerField Class

Определение

Служит базовым классом для типов полей страничного навигатора по данным, который представляет элемент управления перемещением для элемента управления DataPager.Serves as the base class for data pager field types, which represent a navigation control for the DataPager control.

public ref class DataPagerField abstract : System::Web::UI::IStateManager
public abstract class DataPagerField : System.Web.UI.IStateManager
type DataPagerField = class
    interface IStateManager
Public MustInherit Class DataPagerField
Implements IStateManager
Наследование
DataPagerFieldDataPagerFieldDataPagerFieldDataPagerField
Производный
Реализации

Примеры

В следующем примере показано, как использовать NextPreviousPagerField DataPager объекты NumericPagerField, и TemplatePagerField для отображения элементов управления для перемещения по страницам в элементе управления.The following example shows how to use NextPreviousPagerField, NumericPagerField, and TemplatePagerField objects to display page navigation controls in a DataPager control. Объекты являются производными от DataPagerField класса.The objects are derived from the DataPagerField class.

<%@ 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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
      	text-align: center; 
      	font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td>&nbsp;</td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" />
            </b>
            <br /><br />
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="&lt;&lt;"
            NextPageText="&gt;&gt;"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </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>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
      	text-align: center; 
      	font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td>&nbsp;</td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# IIf(Container.TotalRowCount>0, (Container.StartRowIndex / Container.PageSize) + 1, 0) %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling (System.Convert.ToDouble(Container.TotalRowCount) / Container.PageSize) %>" />
            </b>
            <br /><br />            
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="&lt;&lt;"
            NextPageText="&gt;&gt;"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </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 P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Комментарии

DataPagerField Класс выступает в качестве базового класса для всех типов полей пейджера данных.The DataPagerField class serves as the base class for all data pager field types. Поля пейджера данных используются DataPager элементом управления для представления элемента управления навигацией.Data pager fields are used by the DataPager control to represent a navigation control.

Используйте классы, производные от DataPagerField , для выбора типа пейджера, отображаемого DataPager в элементе управления.Use the classes that are derived from DataPagerField to select which type of pager is displayed in the DataPager control. В следующей таблице перечислены доступные типы полей пейджера данных.The following table lists available data pager field types.

Тип поля пейджераPager field type ОписаниеDescription
NextPreviousPagerField Позволяет пользователям перемещаться по страницам данных по одной странице за раз или переходить к первой или последней странице.Lets users navigate through data pages one page at a time, or to jump to the first or last page.
NumericPagerField Позволяет пользователям выбирать страницу по номеру страницы.Lets users select a page by page number.
TemplatePagerField Позволяет разработчикам страниц создавать пользовательский интерфейс разбиения по страницам.Lets page developers create a custom paging UI.

Для создания дополнительных типов полей страничного навигатора можно наследовать от DataPagerField класса.You can derive from the DataPagerField class to create additional pager field types.

Примечания для тех, кто наследует этот метод

При наследовании от DataPagerField класса необходимо переопределить следующие члены:When you inherit from the DataPagerField class, you must override the following members:

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

DataPagerField() DataPagerField() DataPagerField() DataPagerField()

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

Свойства

DataPager DataPager DataPager DataPager

Возвращает ссылку на страничный навигатор, с которым он связан объект DataPagerField.Gets a reference to the data pager that the DataPagerField object is associated with.

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Получает значение, позволяющее определить, отслеживает ли объект DataPagerField изменения в своем состоянии представления.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

QueryStringHandled QueryStringHandled QueryStringHandled QueryStringHandled

Возвращает или задает значение, позволяющее определить, было ли оценено поле строки запроса.Gets or sets a value that indicates whether the query string field has been evaluated.

QueryStringValue QueryStringValue QueryStringValue QueryStringValue

Получает значение поля строки запроса, извлеченное из его URL-адреса.Gets the value of the query string field from the URL of the request.

ViewState ViewState ViewState ViewState

Возвращает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние объекта DataPagerField для нескольких запросов одной и той же страницы.Gets a dictionary of state information that enables you to save and restore the view state of a DataPagerField object across multiple requests for the same page.

Visible Visible Visible Visible

Возвращает или задает значение, указывающее, преобразовывается ли поле страничного навигатора по данным для просмотра.Gets or sets a value that indicates whether a data pager field is rendered.

Методы

CloneField() CloneField() CloneField() CloneField()

Создает копию текущего объекта, производного от объекта DataPagerField.Creates a copy of the current object that is derived from DataPagerField.

CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField) CopyProperties(DataPagerField)

Копирует свойства текущего объекта, производного от объекта DataPagerField в заданный объект DataPagerField.Copies the properties of the current object derived from DataPagerField to the specified DataPagerField object.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

При переопределении в производном классе создает элемент управления пользовательского интерфейса для объекта поля страничного навигатора по данным и добавляет его в указанный контейнер.When overridden in a derived class, creates the user interface (UI) controls for the data pager field object and adds them to the specified container.

CreateField() CreateField() CreateField() CreateField()

При переопределении в производном классе создает пустой объект, производный от объекта DataPagerField.When overridden in a derived class, creates an empty object that is derived DataPagerField.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32) GetQueryStringNavigateUrl(Int32)

Создает URL-адрес, содержащий поле строки запроса, для которого задан номер страницы.Creates a URL that contains a query string field that has the specified page number.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs) HandleEvent(CommandEventArgs)

При переопределении в производном классе обрабатывает события, происходящие в объекте поля страничного навигатора по данным.When overridden in a derived class, handles events that occur in the data pager field object.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Восстанавливает сохраненные ранее сведения о состоянии представления.Restores view-state information that was saved previously.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Создает событие FieldChanged.Raises the FieldChanged event.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет изменения, внесенные в состояние представления объекта DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Инициирует отслеживание объектом DataPagerField изменений в состоянии его представления с целью сохранения их в свойстве элемента управления ViewState и обеспечения их неизменности в различных запросах одной и той же страницы.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

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

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Получает значение, позволяющее определить, отслеживает ли объект DataPagerField изменения в своем состоянии представления.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Восстанавливает сохраненные ранее сведения о состоянии представления.Restores view-state information that was saved previously.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Сохраняет изменения, внесенные в состояние представления объекта DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Инициирует отслеживание объектом DataPagerField изменений в состоянии его представления с целью сохранения их в свойстве элемента управления ViewState и обеспечения их неизменности в различных запросах одной и той же страницы.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

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

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