DataPagerField Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.Extensions.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Serve como classe base para os tipos de campo do pager de dados, que representam um controlo de navegação para o DataPager controlo.

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

Herança: Object
DataPagerField

Derivado: System.Web.UI.WebControls.NextPreviousPagerField

System.Web.UI.WebControls.NumericPagerField

System.Web.UI.WebControls.TemplatePagerField

Implementações: IStateManager

Exemplos

O exemplo seguinte mostra como usar NextPreviousPagerField, , e TemplatePagerField objetos para mostrar os controlos de navegação de página num DataPager controloNumericPagerField. Os objetos derivam da DataPagerField classe.

<%@ 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> </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="<<"
            NextPageText=">>"
            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> </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="<<"
            NextPageText=">>"
            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>

Observações

A DataPagerField classe serve como a classe base para todos os tipos de campo de pagers de dados. Os campos do pager de dados são usados pelo DataPager controlo para representar um controlo de navegação.

Use as classes derivadas de DataPagerField para selecionar que tipo de pager é exibido no DataPager controlo. A tabela seguinte lista os tipos de campos de pagers de dados disponíveis.

Tipo de campo de pager	Description
NextPreviousPagerField	Permite aos utilizadores navegar pelas páginas de dados uma página de cada vez, ou saltar para a primeira ou última página.
NumericPagerField	Permite aos utilizadores selecionar uma página pelo número da página.
TemplatePagerField	Permite aos programadores de páginas criar uma interface personalizada de paginação.

Pode derivar da DataPagerField classe para criar tipos adicionais de campos de pagers.

Notas para Implementadores

Quando herdas da DataPagerField classe, deves sobrepor os seguintes membros:

Construtores

Name	Description
DataPagerField()	Inicializa uma nova instância da DataPagerField classe.

Propriedades

Name	Description
DataPager	Obtém uma referência ao pager de dados ao qual o DataPagerField objeto está associado.
IsTrackingViewState	Obtém um valor que indica se o DataPagerField objeto está a acompanhar as suas alterações no estado de visualização.
QueryStringHandled	Recebe ou define um valor que indica se o campo da string de consulta foi avaliado.
QueryStringValue	Obtém o valor do campo da string de consulta a partir da URL do pedido.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataPagerField objeto através de múltiplos pedidos para a mesma página.
Visible	Recebe ou define um valor que indica se um campo de paginação de dados é renderizado.

Métodos

Name	Description
CloneField()	Cria uma cópia do objeto atual que é derivada de DataPagerField.
CopyProperties(DataPagerField)	Copia as propriedades do objeto atual derivadas de DataPagerField para o objeto especificado DataPagerField .
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Quando sobrescrito numa classe derivada, cria os controlos da interface de utilizador (UI) para o objeto de campo do pager de dados e adiciona-os ao contentor especificado.
CreateField()	Quando sobrescrito numa classe derivada, cria-se um objeto vazio que é derivado DataPagerField.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetQueryStringNavigateUrl(Int32)	Cria uma URL que contém um campo de cadeia de consulta com o número de página especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HandleEvent(CommandEventArgs)	Quando sobrescrito numa classe derivada, gere eventos que ocorrem no objeto de campo do pager de dados.
LoadViewState(Object)	Restaura a informação do estado de visualização que estava guardada anteriormente.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnFieldChanged()	Eleva o `FieldChanged` evento.
SaveViewState()	Guarda as alterações feitas ao DataPagerField estado de visualização do objeto.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o DataPagerField objeto acompanhe alterações ao estado da sua vista para que possam ser armazenadas na propriedade do ViewState controlo e persistir entre pedidos para a mesma página.

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o DataPagerField objeto está a acompanhar as suas alterações no estado de visualização.
IStateManager.LoadViewState(Object)	Restaura a informação do estado de visualização que estava guardada anteriormente.
IStateManager.SaveViewState()	Guarda as alterações feitas ao DataPagerField estado de visualização do objeto.
IStateManager.TrackViewState()	Faz com que o DataPagerField objeto acompanhe alterações ao estado da sua vista para que possam ser armazenadas na propriedade do ViewState controlo e persistir entre pedidos para a mesma página.

Aplica-se a

Ver também

Comentários

Esta página foi útil?