Udostępnij za pośrednictwem


PagerSettings Klasa

Definicja

Reprezentuje właściwości kontrolek stronicowania w kontrolce obsługującej stronicowanie. Klasa ta nie może być dziedziczona.

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
Dziedziczenie
PagerSettings
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu pokazuje, jak używać PagerSettings obiektu zawartego we właściwości w PagerSettings celu dostosowania tekstu przycisków wyświetlanych w wierszu stronicowania kontrolki GridView .


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

Uwagi

Kontrolki obsługujące stronicowanie (takie jak GridView, DetailsViewi FormView ) mogą wyświetlać zestaw kontrolek nazywanych pager , które umożliwiają użytkownikowi nawigowanie po stronach w kontrolce. Klasa PagerSettings jest używana przez te kontrolki do reprezentowania właściwości pagera. Ogólnie rzecz biorąc, PagerSettings obiekt jest przechowywany we PagerSettings właściwości kontrolki. Możesz dostosować pager, ustawiając właściwości PagerSettings obiektu.

Program pager obsługuje kilka różnych trybów wyświetlania. Aby określić tryb wyświetlania pagera, ustaw Mode właściwość . W poniższej tabeli opisano różne tryby.

Tryb Opis
NextPrevious Przyciski poprzedniej strony i następnej strony.
NextPreviousFirstLast Poprzednia strona, następna strona, pierwsza strona i ostatnie przyciski -page.
Numeric Przyciski linków numerowanych w celu uzyskania bezpośredniego dostępu do stron.
NumericFirstLast Ponumerowane przyciski linku, pierwszego linku i ostatniego linku.

Gdy Mode właściwość jest ustawiona na NextPreviouswartość , NextPreviousFirstLastlub NumericFirstLast można dostosować tekst przycisków nieliczbowych, ustawiając właściwości przedstawione w poniższej tabeli.

Właściwość Opis
FirstPageText Tekst przycisku pierwszej strony.
PreviousPageText Tekst przycisku poprzedniej strony.
NextPageText Tekst przycisku następnej strony.
LastPageText Tekst dla ostatniego przycisku strony.

Alternatywnie można również wyświetlać obrazy dla przycisków nieliczbowych, ustawiając właściwości, jak pokazano w poniższej tabeli.

Właściwość Opis
FirstPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku pierwszej strony.
PreviousPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku poprzedniej strony.
NextPageImageUrl Adres URL obrazu do wyświetlenia dla przycisku następnej strony.
LastPageImageUrl Adres URL obrazu do wyświetlenia dla ostatniego przycisku strony.

Uwaga

Po ustawieniu właściwości obrazu odpowiednia właściwość tekstowa działa jako tekst alternatywny obrazu. Na przykład po ustawieniu FirstPageImageUrl właściwości tekst określony przez FirstPageText właściwość jest wyświetlany jako tekst alternatywny obrazu. W przeglądarkach obsługujących etykietki narzędzi ten tekst jest również wyświetlany jako etykietka narzędzia dla odpowiedniego przycisku.

Mode Gdy właściwość jest ustawiona na Numeric wartość lubNumericFirstLast, można określić liczbę przycisków strony do wyświetlenia w pager, ustawiając PageButtonCount właściwość.

Pager może być wyświetlany u góry, u dołu lub zarówno u góry, jak i u dołu kontrolki. Aby określić położenie pagera, ustaw Position właściwość . Aby pokazać lub ukryć pager, użyj Visible właściwości .

Konstruktory

PagerSettings()

Inicjuje nowe wystąpienie klasy PagerSettings.

Właściwości

FirstPageImageUrl

Pobiera lub ustawia adres URL na obraz, aby był wyświetlany dla przycisku pierwszej strony.

FirstPageText

Pobiera lub ustawia tekst do wyświetlenia dla przycisku pierwszej strony.

LastPageImageUrl

Pobiera lub ustawia adres URL na obraz, aby wyświetlić ostatni przycisk strony.

LastPageText

Pobiera lub ustawia tekst do wyświetlenia dla ostatniego przycisku strony.

Mode

Pobiera lub ustawia tryb wyświetlania kontrolek pager w kontrolce obsługującej stronicowanie.

NextPageImageUrl

Pobiera lub ustawia adres URL obrazu w celu wyświetlenia przycisku następnej strony.

NextPageText

Pobiera lub ustawia tekst do wyświetlenia dla przycisku następnej strony.

PageButtonCount

Pobiera lub ustawia liczbę przycisków strony do wyświetlenia w pager, gdy Mode właściwość jest ustawiona Numeric na wartość lub NumericFirstLast .

Position

Pobiera lub ustawia wartość określającą lokalizację, w której jest wyświetlany stronicator.

PreviousPageImageUrl

Pobiera lub ustawia adres URL na obraz, aby był wyświetlany dla przycisku poprzedniej strony.

PreviousPageText

Pobiera lub ustawia tekst do wyświetlenia dla poprzedniego przycisku strony.

Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolki stronicowania są wyświetlane w kontrolce obsługującej stronicowanie.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Pobiera reprezentację PagerSettings ciągu obiektu.

Zdarzenia

PropertyChanged

Występuje, gdy właściwość PagerSettings obiektu zmienia wartości.

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy kontrolka serwera śledzi zmiany stanu widoku.

IStateManager.LoadViewState(Object)

Ładuje wcześniej zapisany stan PagerSettings widoku obiektu.

IStateManager.SaveViewState()

Zapisuje bieżący stan PagerSettings widoku obiektu.

IStateManager.TrackViewState()

Oznacza punkt początkowy, w którym należy rozpocząć śledzenie i zapisywanie zmian stanu widoku w PagerSettings obiekcie.

Dotyczy

Zobacz też