DataPagerField Clase

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 del buscapersonas de datos, que representan un control de navegación para el 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

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 del buscapersonas de datos. El control usa los campos del buscapersonas DataPager 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 del buscapersonas de datos disponibles.

Tipo de campo buscapersonas	Description
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 paginación adicionales.

Notas a los implementadores

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

Constructores

Nombre	Description
DataPagerField()	Inicializa una nueva instancia de la clase DataPagerField.

Propiedades

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

Métodos

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

Implementaciones de interfaz explícitas

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

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?