GridView.AllowPaging GridView.AllowPaging GridView.AllowPaging GridView.AllowPaging Property

Definizione

Ottiene o imposta un valore che indica se la funzionalità di spostamento è abilitata.Gets or sets a value indicating whether the paging feature is enabled.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean

Valore della proprietà

true se la funzionalità di spostamento è abilitata, altrimenti false.true if the paging feature is enabled; otherwise, false. Il valore predefinito è false.The default is false.

Esempi

Nell'esempio seguente viene illustrato come utilizzare la AllowPaging proprietà per abilitare GridView in modo dichiarativo la funzionalità di paging nel controllo.The following example demonstrates how to use the AllowPaging property to declaratively enable the paging feature in the GridView 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 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>

Commenti

Anziché visualizzare contemporaneamente tutti i record nell'origine dati, il GridView controllo può suddividere automaticamente i record in pagine.Instead of displaying all the records in the data source at the same time, the GridView control can automatically break the records up into pages. Se l'origine dati supporta la funzionalità di paging, GridView il controllo può sfruttarlo e fornire funzionalità di paging predefinite.If the data source supports the paging capability, the GridView control can take advantage of that and provide built-in paging functionality. La funzionalità di paging può essere utilizzata con qualsiasi oggetto origine dati che supporta System.Collections.ICollection l'interfaccia o un'origine dati che supporta la funzionalità di paging.The paging feature can be used with any data source object that supports the System.Collections.ICollection interface or a data source that supports paging capability.

Per abilitare la funzionalità di paging, impostare AllowPaging la proprietà truesu.To enable the paging feature, set the AllowPaging property to true. Per impostazione predefinita, GridView il controllo Visualizza 10 record in una pagina alla volta.By default, the GridView control displays 10 records on a page at a time. È possibile modificare il numero di record visualizzati in una pagina impostando la PageSize proprietà.You can change the number of records displayed on a page by setting the PageSize property. Per determinare il numero totale di pagine necessarie per visualizzare il contenuto dell'origine dati, usare PageCount la proprietà.To determine the total number of pages required to display the data source contents, use the PageCount property. È possibile determinare l'indice della pagina attualmente visualizzata utilizzando la PageIndex proprietà.You can determine the index of the currently displayed page by using the PageIndex property.

Quando il paging è abilitato, nel GridView controllo viene visualizzata automaticamente una riga aggiuntiva denominata riga di spostamento.When paging is enabled, an additional row called the pager row is automatically displayed in the GridView control. La riga del pager contiene i controlli che consentono all'utente di passare alle altre pagine.The pager row contains controls that allow the user to navigate to the other pages. È possibile controllare le impostazioni della riga di cercapersone, ad esempio la modalità di visualizzazione del cercapersone, il numero di collegamenti di pagina da visualizzare alla volta e le etichette di testo del controllo pager utilizzando la PagerSettings proprietà.You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text labels) by using the PagerSettings property. La riga del pager può essere visualizzata nella parte superiore, inferiore o nella parte superiore e inferiore del controllo impostando la Position proprietà.The pager row can be displayed at the top, bottom, or both the top and bottom of the control by setting the Position property. È anche possibile selezionare una delle quattro modalità di visualizzazione del cercapersone predefinite impostando la Mode proprietà.You can also select from one of four built-in pager display modes by setting the Mode property. Nella tabella seguente vengono descritte le modalità di visualizzazione predefinite.The following table describes the built-in display modes.

ModalitàMode DescriptionDescription
PagerButton.NextPrevious Set di controlli di paginazione costituito dai pulsanti precedente e successivo.A set of pagination controls consisting of previous and next buttons.
PagerButton.NextPreviousFirstLast Set di controlli di paginazione costituito dai pulsanti precedente, successivo, primo e ultimo.A set of pagination controls consisting of previous, next, first, and last buttons.
PagerButton.Numeric Insieme di controlli di paginazione comprendente pulsanti di collegamento numerati per l'accesso diretto alle pagine con il numero corrispondente.A set of pagination controls consisting of numbered link buttons to access pages directly. Questa è la modalità predefinita.This is the default mode.
PagerButton.NumericFirstLast Set di controlli di impaginazione costituito da pulsanti numerati e primo e ultimo collegamento.A set of pagination controls consisting of numbered and first and last link buttons.

Per controllare l'aspetto della riga di spostamento (inclusi il colore di sfondo, il colore del carattere e la posizione) PagerStyle , utilizzare la proprietà.To control the appearance of the pager row (including its background color, font color, and position), use the PagerStyle property.

Nota

Il GridView controllo nasconde automaticamente la riga del pager quando l'origine dati contiene solo una pagina di record.The GridView control automatically hides the pager row when the data source contains only one page of records.

Il GridView controllo consente inoltre di definire un modello personalizzato per la riga di cercapersone.The GridView control also enables you to define a custom template for the pager row. Per ulteriori informazioni sulla creazione di un modello di riga di cercapersone PagerTemplatepersonalizzato, vedere.For more information about creating a custom pager row template, see PagerTemplate.

Il GridView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando si verifica il paging.The GridView control provides several events that you can use to perform a custom action when paging occurs. Nella tabella seguente sono elencati gli eventi disponibili.The following table lists the available events.

eventEvent DescriptionDescription
PageIndexChanged Si verifica quando viene fatto clic su uno dei pulsanti di spostamento, ma dopo che il controllo GridView ha gestito l'operazione di spostamento.Occurs when one of the pager buttons is clicked, but after the GridView control handles the paging operation. Questo evento viene comunemente usato quando è necessario eseguire un'attività dopo che l'utente passa a una pagina diversa del controllo.This event is commonly used when you need to perform a task after the user navigates to a different page in the control.
PageIndexChanging Si verifica quando viene fatto clic su uno dei pulsanti di spostamento, ma prima che il controllo GridView gestisca l'operazione di spostamento.Occurs when one of the pager buttons is clicked, but before the GridView control handles the paging operation. Questo evento viene spesso usato per annullare l'operazione di paging.This event is often used to cancel the paging operation.

Si applica a

Vedi anche