NextPreviousPagerField Classe
Definizione
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.
Rappresenta un campo che visualizza i controlli per la navigazione in un controllo DataPager che consentono agli utenti di spostarsi tra i dati.
public ref class NextPreviousPagerField : System::Web::UI::WebControls::DataPagerFieldpublic class NextPreviousPagerField : System.Web.UI.WebControls.DataPagerFieldtype NextPreviousPagerField = class
inherit DataPagerFieldPublic Class NextPreviousPagerField
Inherits DataPagerField- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato come usare un NextPreviousPagerField oggetto per la pagina tramite i dati visualizzati in un ListView controllo.
<%@ 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>
<%@ 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>
Commenti
La NextPreviousPagerField classe rappresenta un campo che visualizza i controlli di spostamento in un DataPager controllo. Questi controlli di spostamento possono essere usati per la pagina tramite i dati visualizzati da un controllo che implementa l'interfaccia IPageableItemContainer , ad esempio il ListView controllo.
La NextPreviousPagerField classe fornisce pulsanti che consentono agli utenti di spostarsi tra le pagine di dati una pagina alla volta o di passare alla prima o all'ultima pagina dei dati.
È possibile personalizzare l'aspetto dell'oggetto NextPreviousPagerField usando la ButtonCssClass proprietà per impostare lo stile dei pulsanti. È anche possibile usare la ButtonType proprietà per scegliere il tipo di pulsante visualizzato. Nella tabella seguente sono elencati i tipi di pulsante disponibili.
| Tipo | Descrizione |
|---|---|
| Button | Controllo Button. |
| Image | Controllo ImageButton. |
| Link | Controllo LinkButton. |
È possibile nascondere un oggetto in un DataPagerNextPreviousPagerField controllo impostando la Visible proprietà su false. È anche possibile nascondere i singoli pulsanti (la prima pagina, la pagina precedente, la pagina successiva e i pulsanti dell'ultima pagina) impostando le ShowFirstPageButtonproprietà , ShowNextPageButtonShowPreviousPageButton, e ShowLastPageButton su false.
Il NextPreviousPagerField controllo consente di specificare testo personalizzato per ogni pulsante usando le FirstPageTextproprietà , , NextPageTextPreviousPageTexte LastPageText .
Quando la ButtonType proprietà è impostata su ButtonType.Image, è necessario specificare l'URL di un'immagine che verrà visualizzata per il pulsante. È possibile impostare le immagini singolarmente per ogni pulsante impostando le FirstPageImageUrlproprietà , , PreviousPageImageUrlNextPageImageUrle LastPageImageUrl .
Quando la proprietà è impostata su ButtonType.Image, la ButtonType proprietà di testo corrispondente funge da testo alternativo per l'immagine. Ad esempio, il testo specificato dalla FirstPageText proprietà viene visualizzato come testo alternativo per il pulsante dell'immagine di prima pagina. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando.
Costruttori
| NextPreviousPagerField() |
Inizializza una nuova istanza della classe NextPreviousPagerField. |
Proprietà
| 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) |
Metodi
| CloneField() |
Crea una copia dell'oggetto corrente derivato da DataPagerField. (Ereditato da DataPagerField) |
| CopyProperties(DataPagerField) |
Copia le proprietà dell'oggetto NextPreviousPagerField corrente nell'oggetto DataPagerField specificato. |
| CreateDataPagers(DataPagerFieldItem, Int32, Int32, Int32, Int32) |
Crea i controlli dell'interfaccia utente per l'oggetto campo del pager e li aggiunge al contenitore specificato. |
| CreateField() |
Crea e restituisce una nuova istanza della classe NextPreviousPagerField. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto NextPreviousPagerField corrente. |
| GetHashCode() |
Viene utilizzato come funzione hash per la classe NextPreviousPagerField. |
| GetQueryStringNavigateUrl(Int32) |
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(CommandEventArgs) |
Gestisce gli eventi che si verificano nel controllo NextPreviousPagerField ed esegue l'azione appropriata. |
| LoadViewState(Object) |
Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnFieldChanged() |
Genera l'evento |
| 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) |
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. (Ereditato da DataPagerField) |
| IStateManager.LoadViewState(Object) |
Ripristina informazioni sullo stato di visualizzazione salvate in precedenza. (Ereditato da DataPagerField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione dell'oggetto DataPagerField. (Ereditato da DataPagerField) |
| 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. (Ereditato da DataPagerField) |
