Condividi tramite

PagerSettings.Mode Proprietà

Definizione

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

Ottiene o imposta la modalità in cui visualizzare i controlli cercapersone in un controllo che supporta l'impaginazione.

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 PagerButtons valori. Il valore predefinito è PagerButtons.Numeric.

Eccezioni

ArgumentOutOfRangeException

l'oggetto Mode è impostato su un valore che non è uno dei PagerButtons valori .

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la Mode proprietà per specificare che la riga del cercapersone per un GridView controllo deve visualizzare 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 Mode proprietà per specificare la modalità. Nella tabella seguente vengono descritte le diverse modalità per i controlli di paginazione.

Modalità Descrizione
NextPrevious Pulsanti pagina precedente e pagina successiva.
NextPreviousFirstLast Pulsanti pagina precedente, pagina successiva, prima pagina e ultima pagina.
Numeric Pulsanti di collegamento numerati per accedere direttamente alle pagine.
NumericFirstLast Pulsanti numerati e first-link e last-link.

Quando la Mode proprietà è impostata sul NextPreviousvalore , NextPreviousFirstLasto NumericFirstLast , è possibile specificare testo personalizzato per i pulsanti non numerici impostando le proprietà illustrate nella tabella seguente.

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

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

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

Annotazioni

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