Condividi tramite

GridView.AllowPaging Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se la funzionalità di paging è abilitata.

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à

Boolean

true se la funzionalità di paging è abilitata; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la AllowPaging proprietà per abilitare in modo dichiarativo la funzionalità di paging nel GridView controllo .


<%@ 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 tutti i record nell'origine dati contemporaneamente, il GridView controllo può suddividere automaticamente i record in pagine. Se l'origine dati supporta la funzionalità di paging, il GridView controllo può sfruttare tale funzionalità e offrire funzionalità di paging predefinite. La funzionalità di paging può essere usata con qualsiasi oggetto origine dati che supporta l'interfaccia o un'origine System.Collections.ICollection dati che supporta la funzionalità di paging.

Per abilitare la funzionalità di paging, impostare la AllowPaging proprietà su true. Per impostazione predefinita, il GridView controllo visualizza 10 record in una pagina alla volta. È possibile modificare il numero di record visualizzati in una pagina impostando la PageSize proprietà . Per determinare il numero totale di pagine necessarie per visualizzare il contenuto dell'origine dati, utilizzare la PageCount proprietà . È possibile determinare l'indice della pagina attualmente visualizzata utilizzando la PageIndex proprietà .

Quando il paging è abilitato, nel controllo viene visualizzata GridView automaticamente una riga aggiuntiva denominata riga cercapersone. La riga del cercapersone contiene controlli che consentono all'utente di passare alle altre pagine. È possibile controllare le impostazioni della riga del 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 cercapersone) usando la PagerSettings proprietà . La riga del cercapersone può essere visualizzata nella parte superiore, inferiore o inferiore del controllo impostando la Position proprietà . È anche possibile selezionare una delle quattro modalità di visualizzazione predefinite del cercapersone impostando la Mode proprietà . Nella tabella seguente vengono descritte le modalità di visualizzazione predefinite.

Modalità Descrizione
PagerButton.NextPrevious Set di controlli di paginazione costituiti da pulsanti precedenti e successivi.
PagerButton.NextPreviousFirstLast Set di controlli di paginazione costituiti da pulsanti precedenti, successivi, primi e ultimi.
PagerButton.Numeric Set di controlli di paginazione costituiti da pulsanti di collegamento numerati per accedere direttamente alle pagine. Questa è la modalità predefinita.
PagerButton.NumericFirstLast Set di controlli di paginazione costituiti da pulsanti numerati e primi e ultimo collegamento.

Per controllare l'aspetto della riga del cercapersone (incluso il colore di sfondo, il colore del carattere e la posizione), utilizzare la PagerStyle proprietà .

Annotazioni

Il GridView controllo nasconde automaticamente la riga del cercapersone quando l'origine dati contiene solo una pagina di record.

Il GridView controllo consente inoltre di definire un modello personalizzato per la riga del cercapersone. Per altre informazioni sulla creazione di un modello di riga del cercapersone personalizzato, vedere PagerTemplate.

Il GridView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando si verifica il paging. Nella tabella seguente sono elencati gli eventi disponibili.

Event Descrizione
PageIndexChanged Si verifica quando si fa clic su uno dei pulsanti del cercapersone, ma dopo che il GridView controllo gestisce l'operazione di paging. Questo evento viene comunemente usato quando è necessario eseguire un'attività dopo che l'utente passa a una pagina diversa nel controllo.
PageIndexChanging Si verifica quando si fa clic su uno dei pulsanti del cercapersone, ma prima che il GridView controllo gestisca l'operazione di paging. Questo evento viene spesso usato per annullare l'operazione di paging.

Si applica a

Vedi anche