Freigeben über


PagerSettings Klasse

Definition

Stellt die Eigenschaften der Seitennavigation in einem Steuerelement dar, das die Paginierung unterstützt. Diese Klasse kann nicht vererbt werden.

public ref class PagerSettings sealed : System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class PagerSettings : System.Web.UI.IStateManager
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type PagerSettings = class
    interface IStateManager
Public NotInheritable Class PagerSettings
Implements IStateManager
Vererbung
PagerSettings
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das PagerSettings Objekt verwenden, das in der Eigenschaft enthalten ist, um den Text der Schaltflächen anzupassen, die in der PagerSettings Pagerzeile eines GridView Steuerelements angezeigt werden.


<%@ 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="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            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="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            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>

Hinweise

Steuerelemente, die die Pagination (z. B. die GridViewDetailsView, und FormView Steuerelemente) unterstützen, können einen Satz von Steuerelementen anzeigen, die dem Benutzer die Navigation der Seiten innerhalb des Steuerelements ermöglichen. Die PagerSettings Klasse wird von diesen Steuerelementen verwendet, um die Eigenschaften des Pagers darzustellen. Im Allgemeinen wird das PagerSettings Objekt in der PagerSettings Eigenschaft des Steuerelements gespeichert. Sie können den Pager anpassen, indem Sie die Eigenschaften des PagerSettings Objekts festlegen.

Der Pager unterstützt mehrere verschiedene Anzeigemodi. Um den Modus anzugeben, in dem der Pager angezeigt werden soll, legen Sie die Mode Eigenschaft fest. In der folgenden Tabelle werden die verschiedenen Modi beschrieben.

Mode BESCHREIBUNG
NextPrevious Vorherige Seiten- und Next-Page-Schaltflächen.
NextPreviousFirstLast Vorherige Seite, Nächste Seite, Erste Seite und letzte Seitenschaltflächen.
Numeric Nummerierte Linkschaltflächen, um direkt auf Seiten zuzugreifen.
NumericFirstLast Nummerierte Verknüpfungen, erste Verknüpfungen und Schaltflächen "Last-Link".

Wenn die Mode Eigenschaft auf den NextPreviousWert oder NextPreviousFirstLastden Wert festgelegt ist, NumericFirstLast können Sie den Text der nicht numerischen Schaltflächen anpassen, indem Sie die in der folgenden Tabelle angezeigten Eigenschaften festlegen.

Eigenschaft BESCHREIBUNG
FirstPageText Text für die Schaltfläche "Erste Seite".
PreviousPageText Text für die Schaltfläche "Vorherige Seite".
NextPageText Text für die Schaltfläche "Nächste Seite".
LastPageText Text für die Schaltfläche "Letzte Seite".

Alternativ können Sie auch Bilder für die nicht numerischen Schaltflächen anzeigen, indem Sie die Eigenschaften festlegen, wie in der folgenden Tabelle dargestellt.

Eigenschaft BESCHREIBUNG
FirstPageImageUrl Die URL zu einem Bild, das für die Erste Seite-Schaltfläche angezeigt werden soll.
PreviousPageImageUrl Die URL zu einem Bild, das für die Vorherige Seite-Schaltfläche angezeigt werden soll.
NextPageImageUrl Die URL zu einem Bild, das für die Nächste Seite-Schaltfläche angezeigt werden soll.
LastPageImageUrl Die URL zu einem Bild, das für die Letzte Seite-Schaltfläche angezeigt werden soll.

Hinweis

Wenn eine Bildeigenschaft festgelegt wird, fungiert die entsprechende Texteigenschaft als Alternativtext für das Bild. Wenn die Eigenschaft beispielsweise festgelegt wird, wird der FirstPageImageUrl text, der durch die Eigenschaft angegeben wird, als alternativtext für das FirstPageText Bild angezeigt. In Browsern, die QuickInfos unterstützen, wird dieser Text auch als QuickInfo für die entsprechende Schaltfläche angezeigt.

Wenn die Mode Eigenschaft auf den Numeric NumericFirstLast Wert festgelegt ist, können Sie die Anzahl der Seitenschaltflächen angeben, die im Pager angezeigt werden sollen, indem Sie die PageButtonCount Eigenschaft festlegen.

Der Pager kann oben, unten oder unten eines Steuerelements angezeigt werden. Um die Position des Pagers anzugeben, legen Sie die Position Eigenschaft fest. Um den Pager anzuzeigen oder auszublenden, verwenden Sie die Visible Eigenschaft.

Konstruktoren

PagerSettings()

Initialisiert eine neue Instanz der PagerSettings-Klasse.

Eigenschaften

FirstPageImageUrl

Ruft die URL zu einem Bild ab, das für die Erste Seite-Schaltfläche angezeigt wird, oder legt die URL fest.

FirstPageText

Ruft den Text für die Erste Seite-Schaltfläche ab oder legt diesen fest.

LastPageImageUrl

Ruft die URL zu einem Bild ab, das für die Letzte Seite-Schaltfläche angezeigt werden soll, oder legt die URL fest.

LastPageText

Ruft den Text ab, der für die Letzte Seite-Schaltfläche angezeigt werden soll, oder legt diesen fest.

Mode

Ruft den Modus ab, in dem die Pagersteuerelemente in einem Steuerelement angezeigt werden, das Paginierung unterstützt, oder legt diesen Modus fest.

NextPageImageUrl

Ruft die URL zu einem Bild ab, das für die Nächste Seite-Schaltfläche angezeigt werden soll, oder legt diese URL fest.

NextPageText

Ruft den Text ab, der für die Nächste Seite-Schaltfläche angezeigt werden soll, oder legt diesen fest.

PageButtonCount

Ruft die Anzahl der im Pager anzuzeigenden Seitenschaltflächen ab oder legt diese fest, wenn die Mode-Eigenschaft auf den Numeric-Wert oder den NumericFirstLast-Wert festgelegt ist.

Position

Ruft einen Wert ab, der die Position angibt, an der der Pager angezeigt wird, oder legt einen Wert fest.

PreviousPageImageUrl

Ruft die URL zu einem Bild ab, das für die Vorherige Seite-Schaltfläche angezeigt werden soll, oder legt diese URL fest.

PreviousPageText

Ruft den Text für die Vorherige Seite-Schaltfläche ab oder legt diesen fest.

Visible

Ruft einen Wert ab, der angibt, ob die Pagingsteuerelemente in einem Steuerelement angezeigt werden, das Paginierung unterstützt, oder legt einen Wert fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Ruft die Zeichenfolgendarstellung eines PagerSettings-Objekts ab.

Ereignisse

PropertyChanged

Tritt ein, wenn sich für eine Eigenschaft eines PagerSettings-Objekts Werte ändern.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands nachverfolgt.

IStateManager.LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des PagerSettings-Objekts.

IStateManager.SaveViewState()

Speichert den aktuellen Ansichtszustand des PagerSettings-Objekts.

IStateManager.TrackViewState()

Markiert den Ausgangspunkt, an dem die Nachverfolgung und das Speichern der Ansichtszustandsänderungen des PagerSettings-Objekts beginnen soll.

Gilt für

Siehe auch