GridView.PagerSettings GridView.PagerSettings GridView.PagerSettings GridView.PagerSettings Property

Definición

Obtiene una referencia al objeto PagerSettings que permite establecer las propiedades de los botones de paginación en un control GridView.Gets a reference to the PagerSettings object that enables you to set the properties of the pager buttons in a GridView control.

public:
 virtual property System::Web::UI::WebControls::PagerSettings ^ PagerSettings { System::Web::UI::WebControls::PagerSettings ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.PagerSettings PagerSettings { get; }
member this.PagerSettings : System.Web.UI.WebControls.PagerSettings
Public Overridable ReadOnly Property PagerSettings As PagerSettings

Valor de propiedad

Una referencia a PagerSettings que permite establecer las propiedades de los botones de paginación en un control GridView.A reference to the PagerSettings that enables you to set the properties of the pager buttons in a GridView control.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer PagerSettings la propiedad mediante declaración.The following example demonstrates how to set the PagerSettings property declaratively. Establece la fuente y el fondo de la fila de paginación en azul y azul claro, respectivamente.It sets the font and background for the pager row to blue and light blue, respectively.


<%@ 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Comentarios

Utilice la PagerSettings propiedad para controlar la configuración de la fila de paginación en GridView un control.Use the PagerSettings property to control the settings of the pager row in a GridView control. La fila de paginación se muestra cuando se habilita la característica de paginación ( AllowPaging estableciendo la truepropiedad en) y contiene los controles que permiten al usuario navegar a las distintas páginas del control.The pager row is displayed when the paging feature is enabled (by setting the AllowPaging property to true) and contains the controls that allow the user to navigate to the different pages in the control. Esta propiedad es de solo lectura; sin embargo, puede establecer las propiedades del PagerSettings objeto que devuelve.This property is read-only; however, you can set the properties of the PagerSettings object it returns. Las propiedades se pueden establecer mediante declaración con uno de los métodos siguientes:The properties can be set declaratively using one of the following methods:

  • Coloque un atributo en la etiqueta de apertura del GridView control en el formulario Property-Subproperty, donde Subproperty es una propiedad del PagerSettings objeto (por ejemplo, PagerSettings-Mode).Place an attribute in the opening tag of the GridView control in the form Property-Subproperty, where Subproperty is a property of the PagerSettings object (for example, PagerSettings-Mode).

  • Anide un <PagerSettings> elemento entre las etiquetas GridView de apertura y cierre del control.Nest a <PagerSettings> element between the opening and closing tags of the GridView control.

Las propiedades también se pueden establecer mediante programación en el formulario Property.Subproperty (por ejemplo, PagerStyle.Mode).The properties can also be set programmatically in the form Property.Subproperty (for example, PagerStyle.Mode). La configuración común normalmente incluye el modo de presentación de la fila de buscapersonas y el texto o las imágenes personalizados para los controles de navegación.Common settings usually include the pager row's display mode and custom text or images for the navigation controls.

Se aplica a

Consulte también: