DataPagerField Classe

Definizione

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

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Funge da classe base per i tipi di campo del cercapersone dati, che rappresentano un controllo di spostamento per il DataPager controllo .

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à: Object
DataPagerField

Derivato: System.Web.UI.WebControls.NextPreviousPagerField

System.Web.UI.WebControls.NumericPagerField

System.Web.UI.WebControls.TemplatePagerField

Implementazioni: IStateManager

Esempio

Nell'esempio seguente viene illustrato come utilizzare NextPreviousPagerFieldgli oggetti , NumericPagerFielde TemplatePagerField per visualizzare i controlli di spostamento delle pagine in un DataPager controllo . Gli oggetti sono derivati dalla DataPagerField classe .

<%@ 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> </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="<<"
            NextPageText=">>"
            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> </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="<<"
            NextPageText=">>"
            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 base per tutti i tipi di campo del cercapersone dati. I campi del cercapersone dati vengono utilizzati dal DataPager controllo per rappresentare un controllo di spostamento.

Usare le classi derivate da DataPagerField per selezionare il tipo di cercapersone visualizzato nel DataPager controllo . Nella tabella seguente sono elencati i tipi di campo del cercapersone dati disponibili.

Tipo di campo cercapersone	Description
NextPreviousPagerField	Consente agli utenti di spostarsi tra le pagine di dati una pagina alla volta o di passare alla prima o all'ultima pagina.
NumericPagerField	Consente agli utenti di selezionare una pagina in base al numero di pagina.
TemplatePagerField	Consente agli sviluppatori di pagine di creare un'interfaccia utente di paging personalizzata.

È possibile derivare dalla DataPagerField classe per creare tipi di campo del cercapersone aggiuntivi.

Note per gli implementatori

Quando si eredita dalla DataPagerField classe , è necessario eseguire l'override dei membri seguenti:

Costruttori

Nome	Descrizione
DataPagerField()	Inizializza una nuova istanza della classe DataPagerField.

Proprietà

Nome	Descrizione
DataPager	Ottiene un riferimento al cercapersone dati a cui è associato l'oggetto DataPagerField .
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataPagerField sta monitorando le modifiche dello stato di visualizzazione.
QueryStringHandled	Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato.
QueryStringValue	Ottiene il valore del campo della stringa di query dall'URL della richiesta.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataPagerField oggetto in più richieste per la stessa pagina.
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del cercapersone dati.

Metodi

Nome	Descrizione
CloneField()	Crea una copia dell'oggetto corrente derivato da DataPagerField.
CopyProperties(DataPagerField)	Copia le proprietà dell'oggetto corrente derivato da DataPagerField all'oggetto specificato DataPagerField .
CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)	Quando sottoposto a override in una classe derivata, crea i controlli dell'interfaccia utente per l'oggetto campo del cercapersone dati e li aggiunge al contenitore specificato.
CreateField()	Quando sottoposto a override in una classe derivata, crea un oggetto vuoto derivato da DataPagerField.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetQueryStringNavigateUrl(Int32)	Crea un URL contenente un campo stringa di query con il numero di pagina specificato.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
HandleEvent(CommandEventArgs)	Quando sottoposto a override in una classe derivata, gestisce gli eventi che si verificano nell'oggetto campo del cercapersone dati.
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione salvate in precedenza.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnFieldChanged()	Genera l'evento `FieldChanged`.
SaveViewState()	Salva le modifiche apportate allo DataPagerField stato di visualizzazione dell'oggetto.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Fa in modo che l'oggetto DataPagerField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataPagerField sta monitorando le modifiche dello stato di visualizzazione.
IStateManager.LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione salvate in precedenza.
IStateManager.SaveViewState()	Salva le modifiche apportate allo DataPagerField stato di visualizzazione dell'oggetto.
IStateManager.TrackViewState()	Fa in modo che l'oggetto DataPagerField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?