PagerSettings Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Atrybuty: TypeConverterAttribute

Implementuje: IStateManager

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