Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

TemplatePagerField (Clase)

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

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

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

public class TemplatePagerField : DataPagerField

El tipo TemplatePagerField expone los siguientes miembros.

  NombreDescripción
Método públicoTemplatePagerFieldInicializa una nueva instancia de la clase TemplatePagerField.
Arriba

  NombreDescripción
Propiedad protegidaDataPagerObtiene una referencia al elemento de paginación de datos al que está asociado el objeto DataPagerField. (Se hereda de DataPagerField).
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista. (Se hereda de DataPagerField).
Propiedad públicaPagerTemplateObtiene o establece el contenido personalizado del campo de paginación de un control DataPager.
Propiedad protegidaQueryStringHandledObtiene o establece un valor que indica si se ha evaluado el campo de cadena de consulta. (Se hereda de DataPagerField).
Propiedad protegidaQueryStringValueRecibe el valor del campo de cadena de consulta de la dirección URL de la solicitud. (Se hereda de DataPagerField).
Propiedad protegidaViewStateObtiene 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. (Se hereda de DataPagerField).
Propiedad públicaVisibleObtiene o establece un valor que indica si debe representarse un campo de paginación de datos. (Se hereda de DataPagerField).
Arriba

  NombreDescripción
Método protegidoCloneFieldInfraestructura. Crea una copia del objeto actual que se deriva de DataPagerField. (Se hereda de DataPagerField).
Método protegidoCopyPropertiesCopia las propiedades del objeto TemplatePagerField actual al objeto DataPagerField especificado. (Invalida a DataPagerField.CopyProperties(DataPagerField)).
Método públicoCreateDataPagersCrea los controles de interfaz de usuario (UI) para el objeto de campo de paginación y los agrega al contenedor especificado. (Invalida a DataPagerField.CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)).
Método protegidoCreateFieldCrea y devuelve una nueva instancia de la clase TemplatePagerField. (Invalida a DataPagerField.CreateField()).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método protegidoGetQueryStringNavigateUrlCrea una dirección URL que contiene un campo de cadena de consulta con el número de página especificado. (Se hereda de DataPagerField).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoHandleEventControla los eventos que producen en el objeto TemplatePagerField y realiza la acción adecuada. (Invalida a DataPagerField.HandleEvent(CommandEventArgs)).
Método protegidoLoadViewStateRestaura la información estado de vista que se guardó previamente. (Se hereda de DataPagerField).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnFieldChangedGenera el evento FieldChanged. (Se hereda de DataPagerField).
Método protegidoOnPagerCommandGenera el evento PagerCommand.
Método protegidoSaveViewStateGuarda los cambios realizados en el estado de vista del objeto DataPagerField. (Se hereda de DataPagerField).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateHace 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 hereda de DataPagerField).
Arriba

  NombreDescripción
Evento públicoPagerCommandSe produce cuando se hace clic en un botón de un objeto TemplatePagerField.
Arriba

  NombreDescripción
Implementación explícita de interfacesPropiedad privadaIStateManager.IsTrackingViewStateInfraestructura. Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista. (Se hereda de DataPagerField).
Implementación explícita de interfacesMétodo privadoIStateManager.LoadViewStateInfraestructura. Restaura la información estado de vista que se guardó previamente. (Se hereda de DataPagerField).
Implementación explícita de interfacesMétodo privadoIStateManager.SaveViewStateInfraestructura. Guarda los cambios realizados en el estado de vista del objeto DataPagerField. (Se hereda de DataPagerField).
Implementación explícita de interfacesMétodo privadoIStateManager.TrackViewStateInfraestructura. 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 hereda de DataPagerField).
Arriba

Utilice el objeto TemplatePagerField para mostrar los controles de navegación que permiten a los usuarios recorrer página a página los datos mostrados por un control que implementa la interfaz IPageableItemContainer. (Un ejemplo es el control ListView.) También puede utilizar el objeto TemplatePagerField 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 campo TemplatePagerField no tiene ningún diseño integrado. Por lo tanto, debe crear el diseño explícitamente en la plantilla PagerTemplate. Puede dar formato al contenido utilizando clases de hojas de estilos en cascada (CSS) o elementos de estilo en línea.

Puede hacer referencia al control DataPager que contiene el objeto TemplatePagerField utilizando la propiedad Container. Esto le resultará de gran utilidad si 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 enlaces pueden utilizar propiedades del control DataPager, como MaximumRows, PageSize, StartRowIndex y TotalRowCount.

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

En el ejemplo siguiente se muestra cómo agregar un campo TemplatePagerField a un control DataPager. Este ejemplo utiliza 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 control DataPager también contiene dos campos NextPreviousPagerField y un campo NumericPagerField para mostrar controles de navegación que permiten a los usuarios recorrer los datos página por página.


<%@ 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 evento PagerCommand para realizar una acción diferente en función del botón en el que se haga clic en un campo TemplatePagerField. Este ejemplo utiliza TemplatePagerField para mostrar controles de navegación que permiten a los usuarios recorrer los datos página por página.


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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft