DetailsView.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 di codice seguente viene illustrato come usare la AllowPaging proprietà per abilitare le funzionalità di paging del DetailsView 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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </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>DetailsView AllowPaging Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AllowPaging Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="Customers"
          autogeneraterows="true" 
          allowpaging="true"
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
            
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"/>
            
          <pagerstyle forecolor="White"
            backcolor="Blue"
            font-names="Arial"
            font-size="8" />   
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database. -->           
        <asp:SqlDataSource ID="Customers" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthwindConnectionString %>"
          SelectCommand="SELECT [CompanyName], [ContactName], 
             [CustomerID] FROM [Customers]">
        </asp:SqlDataSource>
            
      </form>
  </body>
</html>

Commenti

Il DetailsView controllo dispone di funzionalità di paging predefinite, che consentono a un utente di passare a un record diverso nell'origine dati.

Il DetailsView controllo può eseguire sia l'interfaccia utente che il paging dell'origine dati. La funzionalità di paging dell'interfaccia utente può essere usata con qualsiasi oggetto origine dati che supporta l'interfaccia System.Collections.ICollection . Per ogni operazione di paging, il DetailsView controllo esegue una query sull'origine dati per l'intera raccolta dati e seleziona la riga da visualizzare, rimuovendo essenzialmente i dati rimanenti.

Se un'origine dati implementa DataSourceView e la CanPage proprietà restituisce true, il DetailsView controllo userà il paging dell'origine dati anziché il paging dell'interfaccia utente. In questo caso, il DetailsView controllo eseguirà una query solo per la riga necessaria per ogni operazione di paging. Di conseguenza, il paging dell'origine dati è più efficiente rispetto al paging dell'interfaccia utente. Solo l'oggetto supporta il paging dell'origine ObjectDataSourceView dati senza modifiche.

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 DetailsView automaticamente una riga aggiuntiva denominata riga cercapersone. La riga del cercapersone contiene i controlli di spostamento della pagina e può essere visualizzata in alto, in basso o sia nella parte superiore che nella parte inferiore del controllo. La riga del cercapersone ha due modalità di visualizzazione predefinite del cercapersone: pagine numerate e collegamenti di pagina successivi e precedenti (impostazione predefinita). La modalità pagine numerate visualizza i collegamenti per le singole pagine, consentendo all'utente di passare a una pagina specifica. La modalità collegamenti successiva e precedente visualizza i controlli che consentono all'utente di passare alla pagina successiva o precedente.

Nota

Il DetailsView 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 tramite la PagerSettings proprietà . Per controllare l'aspetto della riga del cercapersone ,inclusi il colore di sfondo, il colore del carattere e la posizione, utilizzare la PagerStyle proprietà . Il DetailsView 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 DetailsView 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 DetailsView 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 DetailsView gestisca l'operazione di spostamento. Questo evento viene spesso usato per annullare l'operazione di paging.

Il valore di viene archiviato nello stato di AllowPaging visualizzazione.

Si applica a

Vedi anche