DetailsView.AllowPaging Proprietà

Definizione

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 utilizzare AllowPaging la proprietà per abilitare le funzionalità di paging del controllo DetailsView .

<%@ 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 controllo dispone di funzionalità di paging incorporate che consentono a un utente di DetailsView passare a un record diverso nell'origine dati.

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

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

Per abilitare la funzionalità di paging, impostare AllowPaging la 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, nel controllo viene visualizzata automaticamente una riga aggiuntiva denominata riga del DetailsView pager. La riga del pager contiene i controlli di navigazione tra le pagine e può essere visualizzata nella parte superiore, inferiore o nella parte superiore e inferiore del controllo. La riga del pager ha due modalità di visualizzazione del pager predefinite: 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. Nella modalità collegamenti successiva e precedente vengono visualizzati i controlli che consentono all'utente di passare alla pagina successiva o precedente.

Nota

Il DetailsView 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 contemporaneamente e l'etichetta di testo del controllo pager, usando la PagerSettings proprietà . Per controllare l'aspetto della riga del pager, inclusi il colore di sfondo, il colore del carattere e la posizione, usare la PagerStyle proprietà . Il DetailsView controllo consente anche 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 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 AllowPaging viene archiviato nello stato di visualizzazione.

Si applica a

Vedi anche