DataPagerField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.Extensions.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Actúa como clase base para los tipos de campo de paginación de datos, que representan un control de navegación para el control DataPager.

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

Herencia: Object
DataPagerField

Derivado: System.Web.UI.WebControls.NextPreviousPagerField

System.Web.UI.WebControls.NumericPagerField

System.Web.UI.WebControls.TemplatePagerField

Implementaciones: IStateManager

Ejemplos

En el ejemplo siguiente se muestra cómo usar NextPreviousPagerFieldobjetos , NumericPagerFieldy TemplatePagerField para mostrar controles de navegación de página en un DataPager control . Los objetos se derivan de la DataPagerField clase .

<%@ 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>

Comentarios

La DataPagerField clase actúa como clase base para todos los tipos de campo de buscapersonas de datos. El control usa DataPager los campos del buscapersonas de datos para representar un control de navegación.

Use las clases derivadas de DataPagerField para seleccionar el tipo de buscapersonas que se muestra en el DataPager control . En la tabla siguiente se enumeran los tipos de campo de buscapersonas de datos disponibles.

Tipo de campo buscapersonas	Descripción
NextPreviousPagerField	Permite a los usuarios navegar por las páginas de datos una página a la vez o saltar a la primera o última página.
NumericPagerField	Permite a los usuarios seleccionar una página por número de página.
TemplatePagerField	Permite a los desarrolladores de páginas crear una interfaz de usuario de paginación personalizada.

Puede derivar de la DataPagerField clase para crear tipos de campo de buscapersonas adicionales.

Notas a los implementadores

Al heredar de la DataPagerField clase , debe invalidar los siguientes miembros:

Constructores

DataPagerField()

Inicializa una nueva instancia de la clase DataPagerField.

Propiedades

DataPager	Obtiene una referencia al elemento de paginación de datos al que está asociado el objeto DataPagerField.
IsTrackingViewState	Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista.
QueryStringHandled	Obtiene o establece un valor que indica si se ha evaluado el campo de cadena de consulta.
QueryStringValue	Recibe el valor del campo de cadena de consulta de la dirección URL de la solicitud.
ViewState	Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataPagerField en distintas solicitudes de la misma página.
Visible	Obtiene o establece un valor que indica si debe representarse un campo de paginación de datos.

Métodos

CloneField()	Crea una copia del objeto actual que se deriva de DataPagerField.
CopyProperties(DataPagerField)	Copia las propiedades del objeto actual que se deriva de DataPagerField en el objeto DataPagerField especificado.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Cuando se invalida en una clase derivada, crea los controles de interfaz de usuario para el objeto de campo de paginación de datos y los agrega al contenedor especificado.
CreateField()	Cuando se reemplaza en una clase derivada, crea un objeto vacío derivado de DataPagerField.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetQueryStringNavigateUrl(Int32)	Crea una dirección URL que contiene un campo de cadena de consulta con el número de página especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HandleEvent(CommandEventArgs)	Cuando se invalida en una clase derivada, controla los eventos que producen en el objeto de campo de paginación de datos.
LoadViewState(Object)	Restaura la información estado de vista que se guardó previamente.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnFieldChanged()	Genera el evento `FieldChanged`.
SaveViewState()	Guarda los cambios realizados en el estado de vista del objeto DataPagerField.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Hace que el objeto DataPagerField realice un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista.
IStateManager.LoadViewState(Object)	Restaura la información estado de vista que se guardó previamente.
IStateManager.SaveViewState()	Guarda los cambios realizados en el estado de vista del objeto DataPagerField.
IStateManager.TrackViewState()	Hace que el objeto DataPagerField realice un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página.

Se aplica a