PagerSettings.Mode Propiedad

Referencia

Definición

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

Ensamblado:: System.Web.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í.

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

Compartir vía