PagerSettings Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
PagerSettings

Attribute: TypeConverterAttribute

Implementiert: IStateManager

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 GridView DetailsView, 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