PagerSettings.Mode Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.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.

Ottiene o imposta il modo in cui visualizzare i controlli del pager in un controllo che supporta la paginazione.

public:
 property System::Web::UI::WebControls::PagerButtons Mode { System::Web::UI::WebControls::PagerButtons get(); void set(System::Web::UI::WebControls::PagerButtons value); };

public System.Web.UI.WebControls.PagerButtons Mode { get; set; }

member this.Mode : System.Web.UI.WebControls.PagerButtons with get, set

Public Property Mode As PagerButtons

Valore della proprietà

PagerButtons

Uno dei valori di PagerButtons. Il valore predefinito è PagerButtons.Numeric.

Eccezioni

ArgumentOutOfRangeException

La proprietà Mode è impostata su un valore diverso dai valori PagerButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la proprietà per specificare che la Mode riga del pager per un GridView controllo deve visualizzare i pulsanti numerici.


<%@ 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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </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 runat="server">
    <title>PagerSetting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          runat="server">
          
          <pagersettings mode="NumericFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            pagebuttoncount="5"  
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Commenti

I controlli che supportano la paginazione forniscono più modalità in cui visualizzare i controlli di paging. Utilizzare la proprietà per specificare la Mode modalità. Nella tabella seguente vengono descritte le diverse modalità per i controlli di impaginazione.

Mode	Descrizione
NextPrevious	Pulsanti pagina precedente e pagina successiva.
NextPreviousFirstLast	Pulsanti di pagina precedente, pagina successiva, prima pagina e last-page.
Numeric	Pulsanti di collegamento numerati per accedere direttamente alle pagine.
NumericFirstLast	Pulsanti numerati e di primo collegamento e ultimo collegamento.

Quando la Mode proprietà è impostata su NextPrevious, NextPreviousFirstLasto NumericFirstLast valore, è possibile specificare testo personalizzato per i pulsanti non numerici impostando le proprietà visualizzate nella tabella seguente.

Proprietà	Descrizione
FirstPageText	Testo per il pulsante della prima pagina.
PreviousPageText	Testo per il pulsante della pagina precedente.
NextPageText	Testo per il pulsante della pagina successiva.
LastPageText	Testo per il pulsante dell'ultima pagina.

In alternativa, è anche possibile visualizzare immagini per i pulsanti non numerici impostando le proprietà visualizzate nella tabella seguente.

Proprietà	Descrizione
FirstPageImageUrl	URL di un'immagine da visualizzare per il pulsante di collegamento alla prima pagina.
PreviousPageImageUrl	URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina precedente.
NextPageImageUrl	URL di un'immagine da visualizzare per il pulsante di collegamento alla pagina successiva.
LastPageImageUrl	URL di un'immagine da visualizzare per il pulsante di collegamento all'ultima pagina.

Nota

Quando viene impostata una proprietà image, la proprietà di testo corrispondente funge da testo alternativo per l'immagine. Ad esempio, quando la FirstPageImageUrl proprietà è impostata, il testo specificato dalla FirstPageText proprietà viene visualizzato come testo alternativo per l'immagine. Nei browser che supportano le descrizioni comandi, questo testo viene visualizzato anche come descrizione comando per il pulsante corrispondente.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a