PagerSettings Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Sayfalandırmayı destekleyen bir denetimdeki disk belleği denetimlerinin özelliklerini temsil eder. Bu sınıf devralınamaz.

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

Devralma: Object
PagerSettings

Öznitelikler: TypeConverterAttribute

Uygulamalar: IStateManager

Örnekler

Aşağıdaki kod örneği, bir denetimin PagerSettings çağrı aracı satırında görüntülenen düğmelerin metnini özelleştirmek için özelliğinde yer alan PagerSettings nesnenin GridView nasıl kullanılacağını gösterir.


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

Açıklamalar

Sayfalandırmayı GridView DetailsViewdestekleyen denetimler (, , ve FormView denetimleri gibi), kullanıcının denetim içindeki sayfalarda gezinmesine olanak sağlayan , çağrı olarak adlandırılan bir denetim kümesi görüntüleyebilir. sınıfı PagerSettings , bu denetimler tarafından çağrı oluşturucunun özelliklerini temsil etmek için kullanılır. Genel olarak, PagerSettings nesnesi denetimin PagerSettings özelliğinde depolanır. Nesnenin özelliklerini PagerSettings ayarlayarak çağrıyı özelleştirebilirsiniz.

Çağrı kutusu çeşitli farklı görüntüleme modlarını destekler. Çağrıyı yapanın görüntüleneceği modu belirtmek için özelliğini ayarlayın Mode . Aşağıdaki tabloda farklı modlar açıklanmaktadır.

Mod	Description
NextPrevious	Önceki sayfa ve sonraki sayfa düğmeleri.
NextPreviousFirstLast	Önceki sayfa, sonraki sayfa, ilk sayfa ve son sayfa düğmeleri.
Numeric	Sayfalara doğrudan erişmek için numaralandırılmış bağlantı düğmeleri.
NumericFirstLast	Numaralandırılmış bağlantı, ilk bağlantı ve son bağlantı düğmeleri.

Mode özelliği , NextPreviousFirstLastveya NumericFirstLast değerine ayarlandığındaNextPrevious, aşağıdaki tabloda gösterilen özellikleri ayarlayarak sayısal olmayan düğmelerin metnini özelleştirebilirsiniz.

Özellik	Açıklama
FirstPageText	İlk sayfa düğmesinin metni.
PreviousPageText	Önceki sayfa düğmesinin metni.
NextPageText	Sonraki sayfa düğmesinin metni.
LastPageText	Son sayfa düğmesinin metni.

Alternatif olarak, özellikleri aşağıdaki tabloda gösterildiği gibi ayarlayarak sayısal olmayan düğmelerin görüntülerini de görüntüleyebilirsiniz.

Özellik	Açıklama
FirstPageImageUrl	İlk sayfa düğmesi için görüntülenecek görüntünün URL'si.
PreviousPageImageUrl	Önceki sayfa düğmesi için görüntülenecek görüntünün URL'si.
NextPageImageUrl	Sonraki sayfa düğmesi için görüntülenecek görüntünün URL'si.
LastPageImageUrl	Son sayfa düğmesi için görüntülenecek görüntünün URL'si.

Not

Bir görüntü özelliği ayarlandığında, ilgili metin özelliği görüntünün alternatif metni olarak hareket eder. Örneğin, FirstPageImageUrl özellik ayarlandığında, özellik tarafından FirstPageText belirtilen metin görüntünün alternatif metni olarak görüntülenir. Araç İpuçlarını destekleyen tarayıcılarda bu metin, ilgili düğme için Araç İpucu olarak da görüntülenir.

Mode Özellik veya NumericFirstLast değerine ayarlandığındaNumeric, özelliği ayarlayarak PageButtonCount çağrı aracında görüntülenecek sayfa düğmelerinin sayısını belirtebilirsiniz.

Çağrı cihazı, denetimin üstünde, altında veya hem üstünde hem de altında görüntülenebilir. Disk belleğinin konumunu belirtmek için özelliğini ayarlayın Position . Çağrıyı göstermek veya gizlemek için özelliğini kullanın Visible .

Oluşturucular

PagerSettings()

PagerSettings sınıfının yeni bir örneğini başlatır.

Özellikler

FirstPageImageUrl	İlk sayfa düğmesi için görüntülenecek görüntünün URL'sini alır veya ayarlar.
FirstPageText	İlk sayfa düğmesi için görüntülenecek metni alır veya ayarlar.
LastPageImageUrl	Son sayfa düğmesi için görüntülenecek görüntünün URL'sini alır veya ayarlar.
LastPageText	Son sayfa düğmesi için görüntülenecek metni alır veya ayarlar.
Mode	Sayfalandırmayı destekleyen bir denetimde disk belleği denetimlerinin görüntüleneceği modu alır veya ayarlar.
NextPageImageUrl	Sonraki sayfa düğmesi için görüntülenecek bir görüntünün URL'sini alır veya ayarlar.
NextPageText	Sonraki sayfa düğmesi için görüntülenecek metni alır veya ayarlar.
PageButtonCount	Özellik veya değerine ayarlandığında çağrı aracında Mode görüntülenecek sayfa düğmelerinin Numeric sayısını alır veya NumericFirstLast ayarlar.
Position	Disk belleğinin görüntülendiği konumu belirten bir değer alır veya ayarlar.
PreviousPageImageUrl	Önceki sayfa düğmesinin görüntüleneceği URL'yi alır veya ayarlar.
PreviousPageText	Önceki sayfa düğmesi için görüntülenecek metni alır veya ayarlar.
Visible	Sayfalandırma denetimlerinin sayfalandırmayı destekleyen bir denetimde görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Bir PagerSettings nesnenin dize gösterimini alır.

Ekinlikler

PropertyChanged

Bir nesnenin PagerSettings özelliği değerleri değiştirdiğinde gerçekleşir.

Belirtik Arabirim Kullanımları

IStateManager.IsTrackingViewState	Sunucu denetiminin görünüm durumu değişikliklerini izlediğini gösteren bir değer alır.
IStateManager.LoadViewState(Object)	Nesnenin daha önce kaydedilmiş görünüm durumunu PagerSettings yükler.
IStateManager.SaveViewState()	Nesnenin geçerli görünüm durumunu PagerSettings kaydeder.
IStateManager.TrackViewState()	Nesnedeki görünüm durumu değişikliklerini izlemeye ve kaydetmeye başlamak için PagerSettings başlangıç noktasını işaretler.

Şunlara uygulanır