Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TemplatePagerField

 

Publicado: octubre de 2016

Representa un campo DataPager que permite crear una interfaz de usuario de paginación personalizada.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)

System.Object
  System.Web.UI.WebControls.DataPagerField
    System.Web.UI.WebControls.TemplatePagerField

public class TemplatePagerField : DataPagerField

NombreDescripción
System_CAPS_pubmethodTemplatePagerField()

Inicializa una nueva instancia de la clase TemplatePagerField.

NombreDescripción
System_CAPS_protpropertyDataPager

Obtiene una referencia a la paginación de datos que el DataPagerField está asociado el objeto.(Heredado de DataPagerField).

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si la DataPagerField objeto de seguimiento de cambios en su estado de vista.(Heredado de DataPagerField).

System_CAPS_pubpropertyPagerTemplate

Obtiene o establece el contenido personalizado para el campo de paginación en un DataPager control.

System_CAPS_protpropertyQueryStringHandled

Obtiene o establece un valor que indica si se ha evaluado el campo de cadena de consulta.(Heredado de DataPagerField).

System_CAPS_protpropertyQueryStringValue

Obtiene el valor del campo de cadena de consulta de la dirección URL de la solicitud.(Heredado de DataPagerField).

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un DataPagerField objeto en varias solicitudes de la misma página.(Heredado de DataPagerField).

System_CAPS_pubpropertyVisible

Obtiene o establece un valor que indica si se representa un campo de paginación de datos.(Heredado de DataPagerField).

NombreDescripción
System_CAPS_protmethodCloneField()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Crea una copia del objeto actual que se deriva de DataPagerField.(Heredado de DataPagerField).

System_CAPS_protmethodCopyProperties(DataPagerField)

Copia las propiedades del objeto TemplatePagerField objeto especificado DataPagerField objeto.(Invalida DataPagerField.CopyProperties(DataPagerField)).

System_CAPS_pubmethodCreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Crea el usuario en controles de la interfaz (IU) para el objeto de campo de paginación y los agrega al contenedor especificado.(Invalida DataPagerField.CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)).

System_CAPS_protmethodCreateField()

Crea y devuelve una nueva instancia de la clase TemplatePagerField.(Invalida DataPagerField.CreateField()).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_protmethodGetQueryStringNavigateUrl(Int32)

Crea una dirección URL que contiene un campo de cadena de consulta que tiene el número de página especificado.(Heredado de DataPagerField).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodHandleEvent(CommandEventArgs)

Controla los eventos que se producen en el TemplatePagerField de objeto y realiza la acción adecuada.(Invalida DataPagerField.HandleEvent(CommandEventArgs)).

System_CAPS_protmethodLoadViewState(Object)

Restaura la información de estado de vista guardado previamente.(Heredado de DataPagerField).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnFieldChanged()

Genera el evento FieldChanged.(Heredado de DataPagerField).

System_CAPS_protmethodOnPagerCommand(DataPagerCommandEventArgs)

Genera el evento PagerCommand.

System_CAPS_protmethodSaveViewState()

Guarda los cambios realizados en el DataPagerField estado de vista del objeto.(Heredado de DataPagerField).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTrackViewState()

Hace que la DataPagerField objeto que se va a realizar el seguimiento de los cambios en su estado de vista de modo que pueden almacenarse en el control ViewState propiedad y conserven en distintas solicitudes de la misma página.(Heredado de DataPagerField).

NombreDescripción
System_CAPS_pubeventPagerCommand

Se produce cuando se hace clic en un botón en un TemplatePagerField objeto.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Restaura la información de estado de vista guardado previamente.(Heredado de DataPagerField).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Guarda los cambios realizados en el DataPagerField estado de vista del objeto.(Heredado de DataPagerField).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Hace que la DataPagerField objeto que se va a realizar el seguimiento de los cambios en su estado de vista de modo que pueden almacenarse en el control ViewState propiedad y conserven en distintas solicitudes de la misma página.(Heredado de DataPagerField).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene un valor que indica si la DataPagerField objeto de seguimiento de cambios en su estado de vista.(Heredado de DataPagerField).

Utilice la TemplatePagerField objeto para mostrar controles de navegación que permiten a los usuarios desplazarse por los datos que se muestran un control que implementa el IPageableItemContainer interfaz. (Un ejemplo es el ListView control.) También puede utilizar el TemplatePagerField objeto para mostrar información sobre el origen de datos subyacente, como número total de registros y el número de página actual.

El TemplatePagerField campo no tiene ningún diseño integrado. Por lo tanto, debe crear explícitamente el diseño de la PagerTemplate plantilla. Puede dar formato al contenido mediante el uso de clases (CSS) de hojas de estilos en cascada o elementos de estilo en línea.

Puede hacer referencia a la DataPager control que contiene el TemplatePagerField objeto usando el Container propiedad. Esto es útil cuando desea crear expresiones de enlace para mostrar cuántos registros se recuperaron, el número total de páginas e información similar. Estas expresiones de enlace pueden utilizar propiedades de la DataPager de control como MaximumRows, PageSize, StartRowIndex, y TotalRowCount.

El TemplatePagerField campo proporciona el PagerCommand evento, que se utiliza normalmente para realizar una tarea cuando un botón en el PagerTemplate se hace clic en la plantilla.

En el ejemplo siguiente se muestra cómo agregar un TemplatePagerField campo un DataPager control. Este ejemplo se utiliza el TemplatePagerField para mostrar el número de página actual, el número total de páginas y el número total de registros. El DataPager control también contiene dos NextPreviousPagerField campos y un NumericPagerField campo para mostrar los controles de navegación que permiten a los usuarios desplazarse por los datos.

<%@ 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>TemplatePagerField Example</title>    
    <style type="text/css">
      body 	
      {
      	text-align: center;
      	font: 12px Arial, Helvetica, sans-serif;
      }
      .item
      {
        border: solid 1px #458b74;
        background: #e0ffff;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>TemplatePagerField Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblContacts" width="350">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
         </LayoutTemplate>
         <ItemTemplate>
            <tr runat="server">
              <td class="item">
                <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
              </td>            
              <td align="left" class="item">
                <asp:Label ID="NameLabel" runat="server" 
                  Text='<%#Eval("LastName") + ", " + Eval("FirstName")%>' />
              </td>
            </tr>
          </ItemTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ContactsDataPager" 
        PageSize="20"          
        PagedControlID="ContactsListView">
        <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) %>" />
            (
            <asp:Label runat="server" ID="TotalItemsLabel" 
              Text="<%# Container.TotalRowCount%>" />
            records)
            <br />
            </b>
            </PagerTemplate>
          </asp:TemplatePagerField>

          <asp:NextPreviousPagerField
            ButtonType="Button"
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />

          <asp:NumericPagerField 
            PreviousPageText="&lt; Prev 10"
            NextPageText="Next 10 &gt;"
            ButtonCount="10" />

          <asp:NextPreviousPagerField
            ButtonType="Button"
            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 [ContactID], [FirstName], [LastName] 
          FROM Person.Contact">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

En el ejemplo siguiente se muestra cómo utilizar el PagerCommand eventos para realizar una acción diferente dependiendo de qué botón se hizo clic en un TemplatePagerField campo. Este ejemplo se utiliza el TemplatePagerField para mostrar controles de navegación que permiten a los usuarios desplazarse por los datos.

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void TemplatePagerField_OnPagerCommand(object sender, DataPagerCommandEventArgs e)
  { 
    // Check which button raised the event
    switch(e.CommandName)
    {
      case "Next":
        int newIndex = e.Item.Pager.StartRowIndex + e.Item.Pager.PageSize;
        if (newIndex <= e.TotalRowCount)
        {
          e.NewStartRowIndex = newIndex;
          e.NewMaximumRows = e.Item.Pager.MaximumRows;
        }
        break;
      case "Previous":
        e.NewStartRowIndex = e.Item.Pager.StartRowIndex - e.Item.Pager.PageSize;
        e.NewMaximumRows = e.Item.Pager.MaximumRows;
        break;
      case "First":
        e.NewStartRowIndex = 0;
        e.NewMaximumRows = e.Item.Pager.MaximumRows;
        break;
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>TemplatePagerField.OnPagerCommand Example</title>    
    <style type="text/css">
      body 	
      {
      	text-align: center;
      	font: 12px Arial, Helvetica, sans-serif;
      }
      .item
      {
        border: solid 1px #2F4F4F;
        background: #E6E6FA;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>TemplatePagerField.OnPagerCommand Example</h3>

      <asp:ListView ID="StoresListView" 
        DataSourceID="StoresDataSource"
        runat="server">
        <LayoutTemplate>
          <table width="350" runat="server" id="tblStore">
            <tr runat="server">
              <th runat="server">ID</th>
              <th runat="server">Store Name</th>
            </tr>
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
         </LayoutTemplate>
         <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("CustomerID") %>' />
            </td>            
            <td align="left" class="item">
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name")%>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ContactsDataPager" 
        PageSize="30"
        PagedControlID="StoresListView">
        <Fields>
          <asp:TemplatePagerField OnPagerCommand="TemplatePagerField_OnPagerCommand">
            <PagerTemplate> 
              <asp:LinkButton ID="FirstButton" runat="server" CommandName="First" 
                Text="<<" Enabled='<%# Container.StartRowIndex > 0 %>' />
              <asp:LinkButton ID="PreviousButton" runat="server" CommandName="Previous" 
                Text='<%# (Container.StartRowIndex - Container.PageSize + 1) + " - " + (Container.StartRowIndex) %>'
                Visible='<%# Container.StartRowIndex > 0 %>' />
              <asp:Label ID="CurrentPageLabel" runat="server"
                Text='<%# (Container.StartRowIndex + 1) + "-" + (Container.StartRowIndex + Container.PageSize > Container.TotalRowCount ? Container.TotalRowCount : Container.StartRowIndex + Container.PageSize) %>' />
              <asp:LinkButton ID="NextButton" runat="server" CommandName="Next"
                Text='<%# (Container.StartRowIndex + Container.PageSize + 1) + " - " + (Container.StartRowIndex + Container.PageSize*2 > Container.TotalRowCount ? Container.TotalRowCount : Container.StartRowIndex + Container.PageSize*2) %>' 
                Visible='<%# (Container.StartRowIndex + Container.PageSize) < Container.TotalRowCount %>' />
            </PagerTemplate>
          </asp:TemplatePagerField>
        </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="StoresDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT [CustomerID], [Name] FROM Sales.Store ORDER BY [Name]">
      </asp:SqlDataSource>

    </form>
  </body>
</html>

.NET Framework
Disponible desde 3.5

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: