Condividi tramite


PagerSettings.Mode Proprietà

Definizione

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

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

Vedi anche