DataPagerField Classe

Definizione

Funge da classe base per i tipi di campo del pager di dati, che rappresentano un controllo di navigazione per il controllo DataPager.Serves as the base class for data pager field types, which represent a navigation control for the DataPager control.

public ref class DataPagerField abstract : System::Web::UI::IStateManager
public abstract class DataPagerField : System.Web.UI.IStateManager
type DataPagerField = class
    interface IStateManager
Public MustInherit Class DataPagerField
Implements IStateManager
Ereditarietà
DataPagerField
Derivato
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come utilizzare NextPreviousPagerFieldgli NumericPagerFieldoggetti, TemplatePagerField e per visualizzare i controlli di navigazione delle DataPager pagine in un controllo.The following example shows how to use NextPreviousPagerField, NumericPagerField, and TemplatePagerField objects to display page navigation controls in a DataPager control. Gli oggetti sono derivati DataPagerField dalla classe.The objects are derived from the DataPagerField class.

<%@ 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 id="Head1" runat="server">
    <title>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td>&nbsp;</td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# Container.TotalRowCount>0 ? (Container.StartRowIndex / Container.PageSize) + 1 : 0 %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling ((double)Container.TotalRowCount / Container.PageSize) %>" />
            </b>
            <br /><br />
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="&lt;&lt;"
            NextPageText="&gt;&gt;"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </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 id="Head1" runat="server">
    <title>DataPagerField Example</title>    
    <style type="text/css">
      body  
      {
        text-align: center; 
        font: 13px Tahoma, Arial, Helvetica;
      }
      .item
      {
        border-bottom: solid 1px #FFA500;
        font-weight:bold;
      }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>DataPagerField Example</h3>
          
      <asp:ListView ID="ProductsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table runat="server" id="tblProducts" width="350">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td class="item">
              <asp:Label ID="NameLabel" runat="server" 
                Text='<%#Eval("Name") %>' />
            </td>
          </tr>
          <tr runat="server">
            <td>
              <asp:Label ID="DescriptionLabel" runat="server" 
                Text='<%#Eval("Description")%>' />
            </td>
          </tr>
        </ItemTemplate>
        <ItemSeparatorTemplate>
          <tr runat="server">
            <td>&nbsp;</td>
          </tr>
        </ItemSeparatorTemplate>
      </asp:ListView>
      <br />

      <asp:DataPager runat="server" 
        ID="ProductsDataPager" 
        PageSize="5"
        PagedControlID="ProductsListView">
        <Fields>
          <asp:TemplatePagerField>
            <PagerTemplate>
            <b>
            Page
            <asp:Label runat="server" ID="CurrentPageLabel" 
              Text="<%# IIf(Container.TotalRowCount>0, (Container.StartRowIndex / Container.PageSize) + 1, 0) %>" />
            of
            <asp:Label runat="server" ID="TotalPagesLabel" 
              Text="<%# Math.Ceiling (System.Convert.ToDouble(Container.TotalRowCount) / Container.PageSize) %>" />
            </b>
            <br /><br />            
            </PagerTemplate>
          </asp:TemplatePagerField>
          
          <asp:NextPreviousPagerField
            ShowFirstPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
          
          <asp:NumericPagerField 
            PreviousPageText="&lt;&lt;"
            NextPageText="&gt;&gt;"
            ButtonCount="10" />
            
          <asp:NextPreviousPagerField
            ShowLastPageButton="true"
            ShowNextPageButton="false"
            ShowPreviousPageButton="false" />
        </Fields>
      </asp:DataPager>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT P.Name, PD.Description 
                      FROM Production.ProductModel AS PM 
                      INNER JOIN Production.Product AS P ON PM.ProductModelID = P.ProductModelID 
                      INNER JOIN Production.ProductModelProductDescriptionCulture AS PMPDC 
                      ON PM.ProductModelID = PMPDC.ProductModelID 
                      INNER JOIN Production.ProductDescription AS PD 
                      ON PMPDC.ProductDescriptionID = PD.ProductDescriptionID 
                      WHERE (PMPDC.CultureID = 'en')">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Commenti

La DataPagerField classe funge da classe di base per tutti i tipi di campo del pager di dati.The DataPagerField class serves as the base class for all data pager field types. I campi del DataPager pager di dati vengono utilizzati dal controllo per rappresentare un controllo di navigazione.Data pager fields are used by the DataPager control to represent a navigation control.

Utilizzare le classi derivate da DataPagerField per selezionare il DataPager tipo di pager visualizzato nel controllo.Use the classes that are derived from DataPagerField to select which type of pager is displayed in the DataPager control. Nella tabella seguente sono elencati i tipi di campo del pager di dati disponibili.The following table lists available data pager field types.

Tipo di campo cercapersonePager field type DescriptionDescription
NextPreviousPagerField Consente agli utenti di spostarsi tra le pagine di dati una pagina alla volta o di passare alla prima o all'ultima pagina.Lets users navigate through data pages one page at a time, or to jump to the first or last page.
NumericPagerField Consente agli utenti di selezionare una pagina in base al numero di pagina.Lets users select a page by page number.
TemplatePagerField Consente agli sviluppatori di pagine di creare un'interfaccia utente di paging personalizzata.Lets page developers create a custom paging UI.

È possibile derivare dalla DataPagerField classe per creare altri tipi di campo del pager.You can derive from the DataPagerField class to create additional pager field types.

Note per gli implementatori

Quando si eredita dalla DataPagerField classe, è necessario eseguire l'override dei membri seguenti:When you inherit from the DataPagerField class, you must override the following members:

Costruttori

DataPagerField()

Inizializza una nuova istanza della classe DataPagerField.Initializes a new instance of the DataPagerField class.

Proprietà

DataPager

Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato.Gets a reference to the data pager that the DataPagerField object is associated with.

IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

QueryStringHandled

Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato.Gets or sets a value that indicates whether the query string field has been evaluated.

QueryStringValue

Ottiene il valore del campo della stringa di query dall'URL della richiesta.Gets the value of the query string field from the URL of the request.

ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataPagerField tra più richieste per la stessa pagina.Gets a dictionary of state information that enables you to save and restore the view state of a DataPagerField object across multiple requests for the same page.

Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati.Gets or sets a value that indicates whether a data pager field is rendered.

Metodi

CloneField()

Crea una copia dell'oggetto corrente derivato da DataPagerField.Creates a copy of the current object that is derived from DataPagerField.

CopyProperties(DataPagerField)

Copia le proprietà dell'oggetto corrente derivato da DataPagerField nell'oggetto DataPagerField specificato.Copies the properties of the current object derived from DataPagerField to the specified DataPagerField object.

CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)

Quando viene sottoposto a override in una classe derivata, crea i controlli dell'interfaccia utente per l'oggetto campo del pager di dati e li aggiunge al contenitore specificato.When overridden in a derived class, creates the user interface (UI) controls for the data pager field object and adds them to the specified container.

CreateField()

Quando viene sottoposto a override in una classe derivata, crea un oggetto vuoto derivato da DataPagerField.When overridden in a derived class, creates an empty object that is derived DataPagerField.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetQueryStringNavigateUrl(Int32)

Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato.Creates a URL that contains a query string field that has the specified page number.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
HandleEvent(CommandEventArgs)

Quando viene sottoposto a override in una classe derivata, gestisce gli eventi che si verificano nell'oggetto campo del pager di dati.When overridden in a derived class, handles events that occur in the data pager field object.

LoadViewState(Object)

Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.Restores view-state information that was saved previously.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TrackViewState()

Determina la registrazione da parte dell'oggetto DataPagerField delle modifiche apportate al relativo stato di visualizzazione per consentirne l'archiviazione nella proprietà ViewState del controllo e la conservazione nelle richieste relative alla stessa pagina.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value that indicates whether the DataPagerField object is tracking its view-state changes.

IStateManager.LoadViewState(Object)

Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.Restores view-state information that was saved previously.

IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.Saves the changes that were made to the DataPagerField object's view state.

IStateManager.TrackViewState()

Determina la registrazione da parte dell'oggetto DataPagerField delle modifiche apportate al relativo stato di visualizzazione per consentirne l'archiviazione nella proprietà ViewState del controllo e la conservazione nelle richieste relative alla stessa pagina.Causes the DataPagerField object to track changes to its view state so that they can be stored in the control's ViewState property and persisted across requests for the same page.

Si applica a

Vedi anche