Classe NextPreviousPagerField (System.Web.UI.WebControls)

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Classe NextPreviousPagerField

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

Rappresenta un campo che visualizza i controlli di spostamento in un controllo DataPager per consentire agli utenti di spostarsi tra pagine di dati.

Gerarchia di ereditarietà

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

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

Sintassi

Visual Basic

Public Class NextPreviousPagerField _
	Inherits DataPagerField

public class NextPreviousPagerField : DataPagerField

Visual C++

public ref class NextPreviousPagerField : public DataPagerField

type NextPreviousPagerField =  
    class
        inherit DataPagerField
    end

Il tipo NextPreviousPagerField espone i seguenti membri.

Costruttori

	Nome	Descrizione
	NextPreviousPagerField	Inizializza una nuova istanza della classe NextPreviousPagerField.

In alto

Proprietà

	Nome	Descrizione
	ButtonCssClass	Ottiene o imposta la classe del foglio di stile CSS utilizzata per eseguire il rendering dei pulsanti del campo del pager nel browser.
	ButtonType	Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pager.
	DataPager	Ottiene un riferimento al pager di dati a cui l'oggetto DataPagerField è associato. (Ereditato da DataPagerField)
	FirstPageImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla prima pagina.
	FirstPageText	Ottiene o imposta il testo visualizzato per il pulsante relativo alla prima pagina.
	IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataPagerField tiene traccia delle modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataPagerField)
	LastPageImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo all'ultima pagina nell'oggetto NextPreviousPagerField.
	LastPageText	Ottiene o imposta il testo visualizzato per il pulsante relativo all'ultima pagina.
	NextPageImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina successiva nell'oggetto NextPreviousPagerField.
	NextPageText	Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina successiva.
	PreviousPageImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata per il pulsante relativo alla pagina precedente nell'oggetto NextPreviousPagerField.
	PreviousPageText	Ottiene o imposta il testo visualizzato per il pulsante relativo alla pagina precedente.
	QueryStringHandled	Ottiene o imposta un valore che indica se il campo della stringa di query è stato valutato. (Ereditato da DataPagerField)
	QueryStringValue	Ottiene il valore del campo della stringa di query dall'URL della richiesta. (Ereditato da DataPagerField)
	RenderDisabledButtonsAsLabels	Ottiene o imposta un valore che indica se i pulsanti disabilitati sono sottoposti a rendering come controlli Label dall'oggetto NextPreviousPagerField.
	RenderNonBreakingSpacesBetweenControls	Ottiene o imposta un valore che indica se gli spazi unificatori sono sottoposti a rendering tra i controlli.
	ShowFirstPageButton	Ottiene o imposta un valore che indica se il pulsante relativo alla prima pagina viene visualizzato in un oggetto NextPreviousPagerField.
	ShowLastPageButton	Ottiene o imposta un valore che indica se il pulsante relativo all'ultima pagina viene visualizzato in un oggetto NextPreviousPagerField.
	ShowNextPageButton	Ottiene o imposta un valore che indica se il pulsante relativo alla pagina successiva viene visualizzato in un oggetto NextPreviousPagerField.
	ShowPreviousPageButton	Ottiene o imposta un valore che indica se il pulsante relativo alla pagina precedente viene visualizzato in un oggetto NextPreviousPagerField.
	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. (Ereditato da DataPagerField)
	Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo del pager di dati. (Ereditato da DataPagerField)

In alto

Metodi

	Nome	Descrizione
	CloneField	Infrastruttura. Crea una copia dell'oggetto corrente derivato da DataPagerField. (Ereditato da DataPagerField)
	CopyProperties	Copia le proprietà dell'oggetto NextPreviousPagerField corrente nell'oggetto DataPagerField specificato. (Esegue l'override di DataPagerField.CopyProperties(DataPagerField)).
	CreateDataPagers	Crea i controlli dell'interfaccia utente per l'oggetto campo del pager e li aggiunge al contenitore specificato. (Esegue l'override di DataPagerField.CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32)).
	CreateField	Crea e restituisce una nuova istanza della classe NextPreviousPagerField. (Esegue l'override di DataPagerField.CreateField()).
	Equals	Determina se l'oggetto specificato è uguale all'oggetto NextPreviousPagerField corrente. (Esegue l'override di Object.Equals(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	Viene utilizzato come funzione hash per la classe NextPreviousPagerField. (Esegue l'override di Object.GetHashCode()).
	GetQueryStringNavigateUrl	Crea un URL che contiene un campo della stringa di query con il numero di pagina specificato. (Ereditato da DataPagerField)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	HandleEvent	Gestisce gli eventi che si verificano nel controllo NextPreviousPagerField ed esegue l'azione appropriata. (Esegue l'override di DataPagerField.HandleEvent(CommandEventArgs)).
	LoadViewState	Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnFieldChanged	Genera l'evento FieldChanged. (Ereditato da DataPagerField)
	SaveViewState	Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da 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. (Ereditato da DataPagerField)

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. (Ereditato da DataPagerField)
	IStateManager.LoadViewState	Infrastruttura. Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField)
	IStateManager.SaveViewState	Infrastruttura. Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da 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. (Ereditato da DataPagerField)

In alto

Note

La classe NextPreviousPagerField rappresenta un campo che visualizza i controlli di spostamento in un controllo DataPager. Questi controlli di spostamento possono essere utilizzati per scorrere i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer, ad esempio il controllo ListView.

La classe NextPreviousPagerField fornisce i pulsanti che consentono agli utenti di spostarsi tra le pagine di dati una pagina alla volta oppure di passare direttamente alla prima o all'ultima pagina di dati.

È possibile personalizzare l'aspetto dell'oggetto NextPreviousPagerField utilizzando la proprietà ButtonCssClass per impostare lo stile dei pulsanti. È anche possibile utilizzare la proprietà ButtonType per scegliere il tipo di pulsante visualizzato. Nella tabella riportata di seguito vengono elencati tipi di pulsante disponibili.

ButtonType	Oggetto di descrizione
Button	Controllo Button.
Image	Controllo ImageButton.
Link	Controllo LinkButton.

È possibile nascondere un oggetto NextPreviousPagerField in un controllo DataPager impostando la proprietà Visible su false. È anche possibile nascondere i singoli pulsanti (i pulsanti relativi alla prima pagina, alla pagina precedente, alla pagina successiva e all'ultima pagina) impostando le proprietà ShowFirstPageButton, ShowPreviousPageButton, ShowNextPageButton e ShowLastPageButton su false.

Il controllo NextPreviousPagerField consente di specificare il testo personalizzato per ogni pulsante utilizzando le proprietà FirstPageText, PreviousPageText, NextPageText e LastPageText.

Quando la proprietà ButtonType è impostata su ButtonType.Image, è necessario fornire l'URL dell'immagine che verrà visualizzata per il pulsante. È possibile impostare singolarmente le immagini per ogni pulsante tramite le proprietà FirstPageImageUrl, PreviousPageImageUrl, NextPageImageUrl e LastPageImageUrl.

Quando la proprietà ButtonType è impostata su ButtonType.Image, la proprietà di testo corrispondente agisce da testo alternativo per l'immagine. Ad esempio, il testo specificato dalla proprietà FirstPageText viene visualizzato come testo alternativo per il pulsante immagine relativo alla prima pagina. Nei browser che supportano le descrizioni comandi, il testo viene visualizzato anche in questo formato.

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare un oggetto NextPreviousPagerField per spostarsi tra le pagine dei dati visualizzati in un controllo ListView.

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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>NextPreviousPagerField Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </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>NextPreviousPagerField Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>NextPreviousPagerField Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblContacts">
            <tr id="itemPlaceholder" runat="server">
            </tr>
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="ContactIDLabel" runat="server" Text='<%#Eval("ContactID") %>' />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <asp:DataPager runat="server" ID="ContactsDataPager" PagedControlID="ContactsListView">
        <Fields>
          <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true" />
        </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 [ContactID], [FirstName], [LastName] FROM Person.Contact">
      </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

DataPagerField

IPageableItemContainer

ListView

Button

ImageButton

LinkButton

Altre risorse

Cenni preliminari sul controllo server Web ListView

Walkthrough: Displaying, Paging, and Sorting Data Using the ListView Web Server Control