DetailsView.AllowPaging DetailsView.AllowPaging DetailsView.AllowPaging DetailsView.AllowPaging Property

Definizione

Ottiene o imposta un valore che indica se la funzionalità di spostamento è abilitata.Gets or sets a value indicating whether the paging feature is enabled.

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à

true per abilitare la funzionalità di spostamento; in caso contrario, false.true to enable the paging feature; otherwise, false. Il valore predefinito è false.The default is false.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato AllowPaging come utilizzare la proprietà per abilitare le funzionalità DetailsView di paging del controllo.The following code example demonstrates how to use the AllowPaging property to enable the paging capabilities of the DetailsView control.

<%@ 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.The DetailsView control has built-in paging capabilities, which allow a user to navigate to a different record in the data source.

Il DetailsView controllo può eseguire sia l'interfaccia utente sia il paging dell'origine dati.The DetailsView control can perform both user interface (UI) and data source paging. La funzionalità di paging dell'interfaccia utente può essere usata con qualsiasi oggetto origine dati System.Collections.ICollection che supporta l'interfaccia.The UI paging feature can be used with any data source object that supports the System.Collections.ICollection interface. Per ogni operazione di paging, DetailsView il controllo esegue una query sull'origine dati per l'intera raccolta di dati e seleziona la riga da visualizzare, ignorando essenzialmente i dati rimanenti.For each paging operation, the DetailsView control queries the data source for the entire data collection and selects the row to display, essentially discarding the remaining data.

Se un'origine dati implementa DataSourceView e la CanPage proprietà restituisce true, il DetailsView controllo utilizzerà il paging dell'origine dati anziché il paging dell'interfaccia utente.If a data source implements DataSourceView and the CanPage property returns true, the DetailsView control will use data source paging instead of UI paging. In questo caso, il DetailsView controllo eseguirà una query solo per la riga necessaria per ogni operazione di paging.In this case, the DetailsView control will query for only the row needed for each paging operation. Il paging dell'origine dati risulta pertanto più efficiente del paging dell'interfaccia utente.Thus, data source paging is more efficient than UI paging. Solo l' ObjectDataSourceView oggetto supporta il paging dell'origine dati senza alcuna modifica.Only the ObjectDataSourceView object supports data source paging without modification.

Per abilitare la funzionalità di paging, impostare AllowPaging la proprietà truesu.To enable the paging feature, set the AllowPaging property to true. È possibile determinare il numero totale di elementi nell'origine dati sottostante utilizzando la PageCount proprietà.You can determine the total number of items in the underlying data source by using the PageCount property. Per determinare l'indice dell'elemento attualmente visualizzato, utilizzare la PageIndex proprietà.To determine the index of the currently displayed item, use the PageIndex property.

Quando il paging è abilitato, nel DetailsView controllo viene visualizzata automaticamente una riga aggiuntiva denominata riga di spostamento.When paging is enabled, an additional row called the pager row is automatically displayed in the DetailsView control. La riga del pager contiene i controlli di navigazione della pagina e può essere visualizzata nella parte superiore, inferiore o nella parte superiore e inferiore del controllo.The pager row contains the page navigation controls and can be displayed at the top, bottom, or both the top and bottom of the control. La riga del pager include due modalità di visualizzazione del cercapersone predefinite: pagine numerate e collegamenti alla pagina successiva e precedente (impostazione predefinita).The pager row has two built-in pager display modes: numbered pages and next and previous page links (default). La modalità pagine numerate Visualizza i collegamenti per le singole pagine, consentendo all'utente di passare a una pagina specifica.The numbered pages mode displays links for the individual pages, allowing the user to navigate to a specific page. La modalità collegamenti successiva e precedente consente di visualizzare i controlli che consentono all'utente di passare alla pagina successiva o precedente.The next and previous links mode displays controls that allow the user to navigate to the next or the previous page.

Nota

Il DetailsView controllo nasconde automaticamente la riga del pager quando l'origine dati contiene meno di due record.The DetailsView control automatically hides the pager row when the data source contains fewer than two records.

È possibile controllare le impostazioni della riga di 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 pager, usando PagerSettings la proprietà.You can control the settings of the pager row (such as the pager display mode, the number of page links to display at a time, and the pager control's text label) by using the PagerSettings property. Per controllare l'aspetto della riga di spostamento (inclusi il colore di sfondo, il colore del carattere e la posizione) PagerStyle , utilizzare la proprietà.To control the appearance of the pager row (including its background color, font color, and position), use the PagerStyle property. Il DetailsView controllo consente inoltre di definire un modello personalizzato per la riga di cercapersone.The DetailsView control also allows you to define a custom template for the pager row. Per ulteriori informazioni sulla creazione di un modello di riga di cercapersone PagerTemplatepersonalizzato, vedere.For more information on creating a custom pager row template, see PagerTemplate.

Il DetailsView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando si verifica il paging.The DetailsView control provides several events that you can use to perform a custom action when paging occurs. Nella tabella seguente sono elencati gli eventi disponibili.The following table lists the available events.

eventEvent DescriptionDescription
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.Occurs when one of the pager buttons is clicked, but after the DetailsView control handles the paging operation. Questo evento viene comunemente usato quando è necessario eseguire un'attività dopo che l'utente passa a un record diverso nel controllo.This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
PageIndexChanging Si verifica quando viene fatto clic su uno dei pulsanti di spostamento, ma prima che il controllo DetailsView gestisca l'operazione di spostamento.Occurs when one of the pager buttons is clicked, but before the DetailsView control handles the paging operation. Questo evento viene spesso usato per annullare l'operazione di paging.This event is often used to cancel the paging operation.

Il valore di AllowPaging viene archiviato nello stato di visualizzazione.The value of AllowPaging is stored in view state.

Si applica a

Vedi anche