Condividi tramite

FormView.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 per abilitare la funzionalità di paging; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la proprietà per abilitare la AllowPaging funzionalità di paging in un FormView 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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        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>FormView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView AllowPaging Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <pagersettings mode="Numeric"
          position="Bottom"/>
          
        <pagerstyle backcolor="LightBlue"
          horizontalalign="Center"/>
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
          </table>
        
        </itemtemplate> 
                  
      </asp:formview>
          
      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Commenti

Il FormView controllo dispone di funzionalità di paging predefinite, che consentono a un utente di passare a un record diverso nell'origine dati. 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. È possibile determinare il numero totale di elementi nell'origine dati sottostante usando la PageCount proprietà . Per determinare l'indice dell'elemento attualmente visualizzato, utilizzare la PageIndex proprietà .

Quando il paging è abilitato, nel controllo viene visualizzata FormView automaticamente una riga aggiuntiva denominata riga cercapersone. La riga del cercapersone contiene i controlli di spostamento della pagina e può essere visualizzata sia nella parte superiore, inferiore o nella parte superiore che inferiore del controllo. La riga del cercapersone ha quattro modalità di visualizzazione predefinite del cercapersone. Nella tabella seguente vengono descritte le quattro modalità.

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.

Annotazioni

Il FormView controllo nasconde automaticamente la riga del cercapersone quando l'origine dati contiene meno di due record.

È 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 l'etichetta di testo del controllo cercapersone) usando la PagerSettings proprietà . Per controllare l'aspetto della riga del cercapersone (incluso il colore di sfondo e il colore del carattere), utilizzare la PagerStyle proprietà . Il FormView 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 FormView 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 FormView controllo gestisce l'operazione di paging. Questo evento viene comunemente usato quando è necessario eseguire un'attività dopo che l'utente passa a un record diverso nel controllo.
PageIndexChanging Si verifica quando si fa clic su uno dei pulsanti del cercapersone, ma prima che il FormView controllo gestisca l'operazione di paging. Questo evento viene spesso usato per annullare l'operazione di paging.

Annotazioni

Questi eventi non vengono generati quando si modifica la PageIndex proprietà a livello di codice.

Si applica a

Vedi anche