PagerSettings.Mode Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u de modus op waarin de pagerbesturingselementen worden weergegeven in een besturingselement dat paginering ondersteunt.

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

Waarde van eigenschap

PagerButtons

Een van de PagerButtons waarden. De standaardwaarde is PagerButtons.Numeric.

Uitzonderingen

ArgumentOutOfRangeException

De Mode waarde wordt ingesteld op een waarde die niet een van de PagerButtons waarden is.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Mode eigenschap gebruikt om op te geven dat de pagerrij voor een GridView besturingselement numerieke knoppen moet weergeven.


<%@ 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>

Opmerkingen

Besturingselementen die paginering ondersteunen, bieden meerdere modi voor het weergeven van de pagineringsbesturingselementen. Gebruik de Mode eigenschap om de modus op te geven. In de volgende tabel worden de verschillende modi voor pagineringsbesturingselementen beschreven.

Mode Beschrijving
NextPrevious Knoppen vorige en volgende pagina.
NextPreviousFirstLast Knoppen vorige pagina, volgende pagina, eerste pagina en laatste pagina.
Numeric Genummerde koppelingsknoppen om rechtstreeks toegang te krijgen tot pagina's.
NumericFirstLast Genummerde knoppen en knoppen voor eerste koppeling en laatste koppeling.

Wanneer de Mode eigenschap is ingesteld op de NextPrevious, NextPreviousFirstLastof NumericFirstLast waarde, kunt u aangepaste tekst opgeven voor de niet-numerieke knoppen door de eigenschappen in de volgende tabel in te stellen.

Vastgoed Beschrijving
FirstPageText Tekst voor de knop eerste pagina.
PreviousPageText Tekst voor de knop vorige pagina.
NextPageText Tekst voor de knop volgende pagina.
LastPageText Tekst voor de knop Laatste pagina.

Als alternatief kunt u ook afbeeldingen voor de niet-numerieke knoppen weergeven door de eigenschappen in de volgende tabel in te stellen.

Vastgoed Beschrijving
FirstPageImageUrl De URL naar een afbeelding die moet worden weergegeven voor de knop eerste pagina.
PreviousPageImageUrl De URL naar een afbeelding die moet worden weergegeven voor de knop vorige pagina.
NextPageImageUrl De URL naar een afbeelding die moet worden weergegeven voor de knop volgende pagina.
LastPageImageUrl De URL naar een afbeelding die moet worden weergegeven voor de knop laatste pagina.

Note

Wanneer een afbeeldingseigenschap is ingesteld, fungeert de bijbehorende teksteigenschap als de alternatieve tekst voor de afbeelding. Wanneer de FirstPageImageUrl eigenschap bijvoorbeeld is ingesteld, wordt de tekst die door de FirstPageText eigenschap is opgegeven, weergegeven als alternatieve tekst voor de afbeelding. In browsers die knopinfo ondersteunen, wordt deze tekst ook weergegeven als knopinfo voor de bijbehorende knop.

De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.

Van toepassing op

Zie ook