GridView.AllowPaging Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che indica se la funzionalità di spostamento è 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 spostamento è abilitata, altrimenti false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come usare la proprietà per abilitare in modo dichiarativo la AllowPaging 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 fornire 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 tramite la PagerSettings proprietà . La riga del cercapersone può essere visualizzata nella parte superiore, in basso o nella parte superiore e inferiore del controllo impostando la Position proprietà . È anche possibile selezionare da una delle quattro modalità di visualizzazione predefinite del cercapersone impostando la Mode proprietà . Nella tabella seguente vengono descritte le modalità di visualizzazione predefinite.

Mode	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`	Insieme di controlli di paginazione comprendente pulsanti di collegamento numerati per l'accesso diretto alle pagine con il numero corrispondente. Si tratta della 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 ,inclusi il colore di sfondo, il colore del carattere e la posizione, utilizzare la PagerStyle proprietà .

Nota

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

Il GridView controllo consente inoltre di definire un modello personalizzato per la riga del pager. Per altre informazioni sulla creazione di un modello di riga del pager 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 viene fatto clic su uno dei pulsanti di spostamento, ma dopo che il controllo GridView ha gestito l'operazione di spostamento. 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 viene fatto clic su uno dei pulsanti di spostamento, ma prima che il controllo GridView gestisca l'operazione di spostamento. Questo evento viene spesso usato per annullare l'operazione di paging.

Si applica a