Classe DataPagerField (System.Web.UI.WebControls)

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Classe DataPagerField

Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

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

Gerarchia di ereditarietà

System.Object
  System.Web.UI.WebControls.DataPagerField
    System.Web.UI.WebControls.NextPreviousPagerField
    System.Web.UI.WebControls.NumericPagerField
    System.Web.UI.WebControls.TemplatePagerField

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)

Sintassi

Visual Basic

Public MustInherit Class DataPagerField _
	Implements IStateManager

public abstract class DataPagerField : IStateManager

Visual C++

public ref class DataPagerField abstract : IStateManager

[<AbstractClass>]
type DataPagerField =  
    class
        interface IStateManager
    end

Il tipo DataPagerField espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataPagerField	Inizializza una nuova istanza della classe DataPagerField.

In alto

Proprietà

	Nome	Descrizione
	DataPager	Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato.
	IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo 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 oggetto DataPagerField tra più richieste per la stessa pagina.
	Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati.

In alto

Metodi

	Nome	Descrizione
	CloneField	Infrastruttura. Crea una copia dell'oggetto corrente derivato da DataPagerField.
	CopyProperties	Copia le proprietà dell'oggetto corrente derivato da DataPagerField nell'oggetto DataPagerField specificato.
	CreateDataPagers	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.
	CreateField	Quando viene sottoposto a override in una classe derivata, crea un oggetto vuoto derivato da DataPagerField.
	Equals(Object)	Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetQueryStringNavigateUrl	Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato.
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	HandleEvent	Quando viene sottoposto a override in una classe derivata, gestisce gli eventi che si verificano nell'oggetto campo del pager di dati.
	LoadViewState	Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnFieldChanged	Genera l'evento FieldChanged.
	SaveViewState	Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (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.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IStateManager.IsTrackingViewState	Infrastruttura. Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione.
	IStateManager.LoadViewState	Infrastruttura. Ripristina informazioni sullo stato di visualizzazione salvate in precedenza.
	IStateManager.SaveViewState	Infrastruttura. Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField.
	IStateManager.TrackViewState	Infrastruttura. 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.

In alto

Note

La classe DataPagerField funge da classe base per tutti i tipi di campi del pager di dati. I campi del pager di dati vengono utilizzati dal controllo DataPager per rappresentare un controllo di spostamento.

Utilizzare le classi derivate da DataPagerField per selezionare il tipo di pager visualizzato nel controllo DataPager. Nella tabella riportata di seguito sono elencati i tipi di campi del pager di dati disponibili.

Tipo di campo del pager	Oggetto di descrizione
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 di paging personalizzata.

È possibile derivare dalla classe DataPagerField per creare tipi di campi del pager aggiuntivi.

Note per gli eredi

Quando si eredita dalla classe DataPagerField, sottoporre a override i seguenti membri:

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare gli oggetti NextPreviousPagerField, NumericPagerField e TemplatePagerField per visualizzare i controlli di spostamento tra le pagine in un controllo DataPager. Gli oggetti sono derivati dalla classe DataPagerField.

Visual Basic


<%@ 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>


<%@ 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>

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5

Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI.WebControls

DataPager

DataPagerFieldCollection

NextPreviousPagerField

NumericPagerField

TemplatePagerField

Altre risorse

Cenni preliminari sul controllo server Web ListView