FormView.AllowPaging Proprietà

  • Riferimento

Definizione

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

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

Esempio

Nell'esempio seguente viene illustrato come usare la AllowPaging proprietà per abilitare la 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 include 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 dati che supporta la System.Collections.ICollection 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, usare la PageIndex proprietà .

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

Mode Descrizione
PagerButton.NextPrevious Set di controlli di impaginazione costituiti da pulsanti precedenti e successivi.
PagerButton.NextPreviousFirstLast Set di controlli di impaginazione 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 impaginazione costituiti da pulsanti numerati e prima e ultimo collegamento.

Nota

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

È possibile controllare le impostazioni della riga del pager , ad esempio la modalità di visualizzazione del pager, il numero di collegamenti di pagina da visualizzare alla volta e l'etichetta di testo del controllo pager usando la PagerSettings proprietà . Per controllare l'aspetto della riga del pager (incluso il colore di sfondo e il colore del carattere), usare la PagerStyle proprietà . Il FormView 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 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 viene fatto clic su uno dei pulsanti di spostamento, ma dopo che il controllo FormView ha gestito l'operazione di spostamento. 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 viene fatto clic su uno dei pulsanti di spostamento, ma prima che il controllo FormView gestisca l'operazione di spostamento. Questo evento viene spesso usato per annullare l'operazione di paging.

Nota

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

Si applica a

Vedi anche