PagerSettings.Mode Propiedad

  • Referencia

Definición

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

Obtiene o establece el modo en el que se muestran los controles de paginación en un control que admite paginación.

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };
public System.Web.UI.WebControls.PagerButtons Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set
Public Property Mode As PagerButtons

Valor de propiedad

PagerButtons

Uno de los valores de PagerButtons. De manera predeterminada, es PagerButtons.Numeric.

Excepciones

ArgumentOutOfRangeException

La propiedad Mode se establece en un valor que no es uno de los valores de PagerButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la Mode propiedad para especificar que la fila del buscapersonas de un GridView control debe mostrar botones numéricos.


<%@ 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Comentarios

Los controles que admiten la paginación proporcionan varios modos en los que mostrar los controles de paginación. Utilice la Mode propiedad para especificar el modo . En la tabla siguiente se describen los distintos modos de los controles de paginación.

Mode Descripción
NextPrevious Botones de página anterior y página siguiente.
NextPreviousFirstLast Botones de página anterior, página siguiente, primera página y última página.
Numeric Botones de vínculo numerados para acceder directamente a las páginas.
NumericFirstLast Botones numerados y de primer vínculo y de último vínculo.

Cuando la Mode propiedad se establece en el NextPreviousvalor , NextPreviousFirstLasto NumericFirstLast , puede especificar texto personalizado para los botones no numéricos estableciendo las propiedades que se muestran en la tabla siguiente.

Propiedad Descripción
FirstPageText Texto del botón de primera página.
PreviousPageText Texto del botón de página anterior.
NextPageText Texto del botón de página siguiente.
LastPageText Texto del botón de la última página.

Como alternativa, también puede mostrar imágenes para los botones no numéricos estableciendo las propiedades que se muestran en la tabla siguiente.

Propiedad Descripción
FirstPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de primera página.
PreviousPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página anterior.
NextPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de página siguiente.
LastPageImageUrl La dirección URL de la imagen que se va a mostrar para el botón de última página.

Nota

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

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también