PagerSettings PagerSettings PagerSettings PagerSettings Class

Definition

Stellt die Eigenschaften der Seitennavigation in einem Steuerelement dar, das die Paginierung unterstützt.Represents the properties of the paging controls in a control that supports pagination. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das PagerSettings -Objekt, das in der PagerSettings -Eigenschaft enthalten ist, verwendet wird, um den Text der Schaltflächen anzupassen, die in GridView der Pager-Zeile eines-Steuer Elements angezeigt werden.The following code example demonstrates how to use the PagerSettings object that is contained in the PagerSettings property to customize the text of the buttons that are displayed in the pager row of a GridView control.


<%@ 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 Paginierung unterstützen ( GridViewz DetailsView. b FormView . die Steuerelemente, und), können eine Reihe von Steuerelementen anzeigen, die als Pager bezeichnet werden, sodass der Benutzer durch die Seiten im Steuerelement navigieren kann.Controls that support pagination (such as the GridView, DetailsView, and FormView controls) can display a set of controls called the pager that allows the user to navigate the pages within the control. Die PagerSettings -Klasse wird von diesen Steuerelementen verwendet, um die Eigenschaften des Pager darzustellen.The PagerSettings class is used by these controls to represent the properties of the pager. Im Allgemeinen wird das PagerSettings -Objekt in der PagerSettings -Eigenschaft des-Steuer Elements gespeichert.In general, the PagerSettings object is stored in the PagerSettings property of the control. Sie können den Pager anpassen, indem Sie die Eigenschaften des PagerSettings Objekts festlegen.You can customize the pager by setting the properties of the PagerSettings object.

Der Pager unterstützt verschiedene Anzeigemodi.The pager supports several different display modes. Um den Modus anzugeben, in dem der Pager angezeigt werden soll, Mode legen Sie die-Eigenschaft fest.To specify the mode in which to display the pager, set the Mode property. In der folgenden Tabelle werden die verschiedenen Modi beschrieben.The following table describes the different modes.

ModusMode BeschreibungDescription
NextPrevious Schaltflächen der vorherigen Seite und der nächsten Seite.Previous-page and next-page buttons.
NextPreviousFirstLast Die Schaltflächen vorherige Seite, nächste Seite, erste Seite und letzte Seite.Previous-page, next-page, first-page, and last -page buttons.
Numeric Nummerierte Link Schaltflächen zum direkten Zugriff auf Seiten.Numbered link buttons to access pages directly.
NumericFirstLast Nummerierte Link-, First-Link-und Last Link-Schaltflächen.Numbered-link, first-link, and last-link buttons.

Wenn die Mode -Eigenschaft auf den NextPrevious-, NextPreviousFirstLast-oder NumericFirstLast -Wert festgelegt ist, können Sie den Text der nicht numerischen Schaltflächen anpassen, indem Sie die in der folgenden Tabelle aufgeführten Eigenschaften festlegen.When the Mode property is set to the NextPrevious, NextPreviousFirstLast, or NumericFirstLast value you can customize the text of the non-numeric buttons by setting the properties shown in the following table.

EigenschaftProperty BeschreibungDescription
FirstPageText Text für die erste Seite-Schaltfläche.Text for the first-page button.
PreviousPageText Text für die Schaltfläche für die vorherige Seite.Text for the previous-page button.
NextPageText Text für die Schaltfläche für die nächste Seite.Text for the next-page button.
LastPageText Der Text für die letzte Seite-Schaltfläche.Text for the last-page button.

Als Alternative können Sie auch Bilder für die nicht numerischen Schaltflächen anzeigen, indem Sie die Eigenschaften festlegen, wie in der folgenden Tabelle gezeigt.As an alternative, you can also display images for the non-numeric buttons by setting the properties as shown in the following table.

EigenschaftProperty BeschreibungDescription
FirstPageImageUrl Die URL zu einem Bild, das für die Erste Seite-Schaltfläche angezeigt werden soll.The URL to an image to display for the first-page button.
PreviousPageImageUrl Die URL zu einem Bild, das für die Vorherige Seite-Schaltfläche angezeigt werden soll.The URL to an image to display for the previous-page button.
NextPageImageUrl Die URL zu einem Bild, das für die Nächste Seite-Schaltfläche angezeigt werden soll.The URL to an image to display for the next-page button.
LastPageImageUrl Die URL zu einem Bild, das für die Letzte Seite-Schaltfläche angezeigt werden soll.The URL to an image to display for the last-page button.

Hinweis

Wenn eine Image-Eigenschaft festgelegt ist, fungiert die entsprechende Text-Eigenschaft als alternativer Text für das Bild.When an image property is set, the corresponding text property acts as the alternate text for the image. Wenn z. b. FirstPageImageUrl die-Eigenschaft festgelegt ist, wird der Text, FirstPageText der von der-Eigenschaft angegeben wird, als alternativer Text für das Bild angezeigt.For example, when the FirstPageImageUrl property is set, the text that is specified by the FirstPageText property is displayed as the alternate text for the image. In Browsern, die Quick Infos unterstützen, wird dieser Text auch als QuickInfo für die entsprechende Schaltfläche angezeigt.On browsers that support ToolTips, this text is also displayed as a ToolTip for the corresponding button.

Wenn die Mode -Eigenschaft auf den- Numeric Wert NumericFirstLast oder den-Wert festgelegt ist, können Sie die Anzahl der Seiten Schaltflächen angeben, PageButtonCount die im Pager angezeigt werden, indem Sie die-EigenschaftWhen the Mode property is set to the Numeric or NumericFirstLast value, you can specify the number of page buttons to display in the pager by setting the PageButtonCount property.

Der Pager kann am oberen, unteren oder oberen und unteren Rand eines Steuer Elements angezeigt werden.The pager can be displayed at the top, the bottom, or both the top and bottom of a control. Um die Position des Pager anzugeben, legen Sie die Position -Eigenschaft fest.To specify the position of the pager, set the Position property. Verwenden Sie die Visible -Eigenschaft, um den Pager anzuzeigen oder auszublenden.To show or hide the pager, use the Visible property.

Konstruktoren

PagerSettings() PagerSettings() PagerSettings() PagerSettings()

Initialisiert eine neue Instanz der PagerSettings-Klasse.Initializes a new instance of the PagerSettings class.

Eigenschaften

FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl FirstPageImageUrl

Ruft die URL zu einem Bild ab, das für die Erste Seite-Schaltfläche angezeigt wird, oder legt die URL fest.Gets or sets the URL to an image to display for the first-page button.

FirstPageText FirstPageText FirstPageText FirstPageText

Ruft den Text für die Erste Seite-Schaltfläche ab oder legt diesen fest.Gets or sets the text to display for the first-page button.

LastPageImageUrl LastPageImageUrl LastPageImageUrl LastPageImageUrl

Ruft die URL zu einem Bild ab, das für die Letzte Seite-Schaltfläche angezeigt werden soll, oder legt die URL fest.Gets or sets the URL to an image to display for the last-page button.

LastPageText LastPageText LastPageText LastPageText

Ruft den Text ab, der für die Letzte Seite-Schaltfläche angezeigt werden soll, oder legt diesen fest.Gets or sets the text to display for the last-page button.

Mode Mode Mode Mode

Ruft den Modus ab, in dem die Pagersteuerelemente in einem Steuerelement angezeigt werden, das Paginierung unterstützt, oder legt diesen Modus fest.Gets or sets the mode in which to display the pager controls in a control that supports pagination.

NextPageImageUrl NextPageImageUrl NextPageImageUrl 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.Gets or sets the URL to an image to display for the next-page button.

NextPageText NextPageText NextPageText NextPageText

Ruft den Text ab, der für die Nächste Seite-Schaltfläche angezeigt werden soll, oder legt diesen fest.Gets or sets the text to display for the next-page button.

PageButtonCount PageButtonCount PageButtonCount 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.Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.

Position Position Position Position

Ruft einen Wert ab, der die Position angibt, an der der Pager angezeigt wird, oder legt einen Wert fest.Gets or sets a value that specifies the location where the pager is displayed.

PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl PreviousPageImageUrl

Ruft die URL zu einem Bild ab, das für die Vorherige Seite-Schaltfläche angezeigt werden soll, oder legt diese URL fest.Gets or sets the URL to an image to display for the previous-page button.

PreviousPageText PreviousPageText PreviousPageText PreviousPageText

Ruft den Text für die Vorherige Seite-Schaltfläche ab oder legt diesen fest.Gets or sets the text to display for the previous page button.

Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob die Pagingsteuerelemente in einem Steuerelement angezeigt werden, das Paginierung unterstützt, oder legt einen Wert fest.Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Ruft die Zeichenfolgendarstellung eines PagerSettings-Objekts ab.Retrieves the string representation of a PagerSettings object.

Ereignisse

PropertyChanged PropertyChanged PropertyChanged PropertyChanged

Tritt ein, wenn sich für eine Eigenschaft eines PagerSettings-Objekts Werte ändern.Occurs when a property of a PagerSettings object changes values.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands nachverfolgt.Gets a value that indicates whether the server control is tracking its view state changes.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des PagerSettings-Objekts.Loads the previously saved view state of the PagerSettings object.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert den aktuellen Ansichtszustand des PagerSettings-Objekts.Saves the current view state of the PagerSettings object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Markiert den Ausgangspunkt, an dem die Nachverfolgung und das Speichern der Ansichtszustandsänderungen des PagerSettings-Objekts beginnen soll.Marks the starting point at which to begin tracking and saving view state changes to the PagerSettings object.

Gilt für:

Siehe auch