NextPreviousPagerField 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í.

Representa un campo que muestra los controles de navegación en un control DataPager que permiten paginar por los datos.

public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerField

public class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerField

type NextPreviousPagerField = class
    inherit DataPagerField

Public Class NextPreviousPagerField
Inherits DataPagerField

Herencia: Object

DataPagerField
NextPreviousPagerField

Ejemplos

En el ejemplo siguiente se muestra cómo usar un NextPreviousPagerField objeto para paginar los datos que se muestran en un ListView control .

<%@ 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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>

<%@ 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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>NextPreviousPagerField Example</h3>
          
      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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>

Comentarios

La NextPreviousPagerField clase representa un campo que muestra controles de navegación en un DataPager control . Estos controles de navegación se pueden usar para paginar a través de datos que se muestran mediante un control que implementa la IPageableItemContainer interfaz, como el ListView control .

La NextPreviousPagerField clase proporciona botones que permiten a los usuarios navegar por las páginas de datos de una página a la vez o saltar a la primera o última página de datos.

Puede personalizar la apariencia del NextPreviousPagerField objeto mediante la ButtonCssClass propiedad para establecer el estilo de los botones. También puede usar la ButtonType propiedad para elegir el tipo de botón que se muestra. En la tabla siguiente se enumeran los tipos de botón disponibles.

Tipo de botón	Descripción
Button	Un control Button.
Image	Control ImageButton.
Link	Un control LinkButton.

Puede ocultar un NextPreviousPagerField objeto en un DataPager control estableciendo la Visible propiedad falseen . También puede ocultar los botones individuales (los botones de primera página, página anterior, página siguiente y última página) estableciendo las ShowFirstPageButtonpropiedades , ShowPreviousPageButton, ShowNextPageButtony ShowLastPageButton en false.

El NextPreviousPagerField control permite especificar texto personalizado para cada botón mediante las FirstPageTextpropiedades , PreviousPageText, NextPageTexty LastPageText .

Cuando la ButtonType propiedad se establece ButtonType.Imageen , debe proporcionar la dirección URL a una imagen que se mostrará para el botón. Puede establecer imágenes individualmente para cada botón estableciendo las FirstPageImageUrlpropiedades , PreviousPageImageUrl, NextPageImageUrly LastPageImageUrl .

Cuando la ButtonType propiedad se establece ButtonType.Imageen , la propiedad de texto correspondiente actúa como texto alternativo para la imagen. Por ejemplo, el texto especificado por la FirstPageText propiedad se muestra como texto alternativo para el botón de imagen de primera página. En los exploradores que admiten información sobre herramientas, este texto también se muestra como información sobre herramientas.

Constructores

NextPreviousPagerField()

Inicializa una nueva instancia de la clase NextPreviousPagerField.

Propiedades

ButtonCssClass	Obtiene o establece la clase de hoja de estilos en cascada (CSS) que se utiliza para representar los botones del campo de paginación en el explorador.
ButtonType	Obtiene o establece el tipo de botón que se va a mostrar en el campo de paginación.
DataPager	Obtiene una referencia al elemento de paginación de datos al que está asociado el objeto DataPagerField. (Heredado de DataPagerField)
FirstPageImageUrl	Obtiene o establece la dirección URL de la imagen que se muestra para el botón de primera página.
FirstPageText	Obtiene o establece el texto que se muestra para el botón de primera página.
IsTrackingViewState	Obtiene un valor que indica si el objeto DataPagerField está realizando un seguimiento de los cambios en su estado de vista. (Heredado de DataPagerField)
LastPageImageUrl	Obtiene o establece la dirección URL de una imagen que se muestra para el botón de última página en el objeto NextPreviousPagerField.
LastPageText	Obtiene o establece el texto que se muestra para el botón de última página.
NextPageImageUrl	Obtiene o establece la dirección URL de una imagen que se muestra para el botón de página siguiente en el objeto NextPreviousPagerField.
NextPageText	Obtiene o establece el texto que se muestra para el botón de página siguiente.
PreviousPageImageUrl	Obtiene o establece la dirección URL de una imagen que se muestra para el botón de página anterior en el objeto NextPreviousPagerField.
PreviousPageText	Obtiene o establece el texto que se muestra para el botón de página anterior.
QueryStringHandled	Obtiene o establece un valor que indica si se ha evaluado el campo de cadena de consulta. (Heredado de DataPagerField)
QueryStringValue	Recibe el valor del campo de cadena de consulta de la dirección URL de la solicitud. (Heredado de DataPagerField)
RenderDisabledButtonsAsLabels	Obtiene o establece un valor que indica si el objeto Label representa los botones deshabilitados como controles NextPreviousPagerField.
RenderNonBreakingSpacesBetweenControls	Obtiene o establece un valor que indica si los espacios de no separación se representan entre los controles.
ShowFirstPageButton	Obtiene o establece un valor que indica si el botón de primera página se muestra en un objeto NextPreviousPagerField.
ShowLastPageButton	Obtiene o establece un valor que indica si el botón de última página se muestra en un objeto NextPreviousPagerField.
ShowNextPageButton	Obtiene o establece un valor que indica si el botón de página siguiente se muestra en un objeto NextPreviousPagerField.
ShowPreviousPageButton	Obtiene o establece un valor que indica si el botón de página anterior se muestra en un objeto NextPreviousPagerField.
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. (Heredado de DataPagerField)
Visible	Obtiene o establece un valor que indica si debe representarse un campo de paginación de datos. (Heredado de DataPagerField)

Métodos

CloneField()	Crea una copia del objeto actual que se deriva de DataPagerField. (Heredado de DataPagerField)
CopyProperties(DataPagerField)	Copia las propiedades del objeto NextPreviousPagerField actual al objeto DataPagerField especificado.
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Crea los controles de interfaz de usuario (UI) para el objeto de campo de paginación y los agrega al contenedor especificado.
CreateField()	Crea y devuelve una nueva instancia de la clase NextPreviousPagerField.
Equals(Object)	Determina si el objeto especificado es igual al objeto NextPreviousPagerField actual.
GetHashCode()	Sirve como función hash para la clase NextPreviousPagerField.
GetQueryStringNavigateUrl(Int32)	Crea una dirección URL que contiene un campo de cadena de consulta con el número de página especificado. (Heredado de DataPagerField)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HandleEvent(CommandEventArgs)	Controla los eventos que producen en el control NextPreviousPagerField y realiza la acción adecuada.
LoadViewState(Object)	Restaura la información estado de vista que se guardó previamente. (Heredado de DataPagerField)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnFieldChanged()	Genera el evento `FieldChanged`. (Heredado de DataPagerField)
SaveViewState()	Guarda los cambios realizados en el estado de vista del objeto DataPagerField. (Heredado de 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. (Heredado de DataPagerField)

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. (Heredado de DataPagerField)
IStateManager.LoadViewState(Object)	Restaura la información estado de vista que se guardó previamente. (Heredado de DataPagerField)
IStateManager.SaveViewState()	Guarda los cambios realizados en el estado de vista del objeto DataPagerField. (Heredado de 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. (Heredado de DataPagerField)

Se aplica a