Aracılığıyla paylaş

GridView.AllowPaging Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Disk belleği özelliğinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

public:
 virtual property bool AllowPaging { bool get(); void set(bool value); };
public virtual bool AllowPaging { get; set; }
member this.AllowPaging : bool with get, set
Public Overridable Property AllowPaging As Boolean

Özellik Değeri

Boolean

true disk belleği özelliği etkinse; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki örnek, denetimde AllowPaging disk belleği özelliğini bildirimli olarak etkinleştirmek için özelliğinin 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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        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>GridView AllowPaging Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView AllowPaging Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">
                
        <pagersettings mode="Numeric"
          position="Bottom"           
          pagebuttoncount="10"/>
                      
        <pagerstyle backcolor="LightBlue"
          height="30px"
          verticalalign="Bottom"
          horizontalalign="Center"/>
                
      </asp:gridview>
            
      <!-- 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Açıklamalar

Denetim, GridView veri kaynağındaki tüm kayıtları aynı anda görüntülemek yerine otomatik olarak kayıtları sayfalara bölebilir. Veri kaynağı disk belleği özelliğini destekliyorsa, GridView denetim bundan yararlanabilir ve yerleşik disk belleği işlevi sağlayabilir. Disk belleği özelliği, arabirimi destekleyen System.Collections.ICollection herhangi bir veri kaynağı nesnesiyle veya disk belleği özelliğini destekleyen bir veri kaynağıyla kullanılabilir.

Disk belleği özelliğini etkinleştirmek için özelliğini olarak trueayarlayınAllowPaging. Varsayılan olarak, GridView denetim bir sayfada aynı anda 10 kayıt görüntüler. Özelliğini ayarlayarak PageSize sayfada görüntülenen kayıt sayısını değiştirebilirsiniz. Veri kaynağı içeriğini görüntülemek için gereken toplam sayfa sayısını belirlemek için özelliğini kullanın PageCount . özelliğini kullanarak o anda görüntülenen sayfanın dizinini PageIndex belirleyebilirsiniz.

Disk belleği etkinleştirildiğinde, denetimde GridView disk belleği satırı adlı ek bir satır otomatik olarak görüntülenir. Çağrı satırı, kullanıcının diğer sayfalara gitmesine olanak sağlayan denetimler içerir. Özelliğini kullanarak PagerSettings , disk belleği satırının ayarlarını (çağrıyıc görüntüleme modu, bir kerede görüntülenecek sayfa bağlantılarının sayısı ve disk belleği denetiminin metin etiketleri gibi) denetleyebilirsiniz. Çağrı cihazı satırı, özelliği ayarlanarak Position denetimin üstünde, altında veya hem üstünde hem de altında görüntülenebilir. Özelliğini ayarlayarak dört yerleşik disk belleği görüntüleme modundan Mode birini de seçebilirsiniz. Aşağıdaki tabloda yerleşik görüntü modları açıklanmaktadır.

Modu Açıklama
PagerButton.NextPrevious Önceki ve sonraki düğmelerden oluşan sayfalandırma denetimleri kümesi.
PagerButton.NextPreviousFirstLast Önceki, sonraki, ilk ve son düğmelerden oluşan sayfalandırma denetimleri kümesi.
PagerButton.Numeric Sayfalara doğrudan erişmek için numaralandırılmış bağlantı düğmelerinden oluşan sayfalandırma denetimleri kümesi. Bu, varsayılan moddur.
PagerButton.NumericFirstLast Numaralandırılmış ve ilk ve son bağlantı düğmelerinden oluşan sayfalandırma denetimleri kümesi.

Çağrı satırı görünümünü denetlemek için (arka plan rengi, yazı tipi rengi ve konumu dahil), özelliğini kullanın PagerStyle .

Uyarı

Veri GridView kaynağı yalnızca bir kayıt sayfası içerdiğinde, denetim çağrı satırı otomatik olarak gizler.

Denetim GridView , çağrı satırı için özel bir şablon tanımlamanızı da sağlar. Özel disk belleği satırı şablonu oluşturma hakkında daha fazla bilgi için bkz PagerTemplate. .

Denetim, GridView disk belleği oluştuğunda özel bir eylem gerçekleştirmek için kullanabileceğiniz çeşitli olaylar sağlar. Aşağıdaki tabloda kullanılabilir olaylar listelenir.

Etkinlik Açıklama
PageIndexChanged Çağrı cihaz düğmelerinden birine tıklandığında, ancak denetim disk belleği işlemini işledikten sonra GridView gerçekleşir. Bu olay genellikle kullanıcı denetimde farklı bir sayfaya gittikten sonra bir görev gerçekleştirmeniz gerektiğinde kullanılır.
PageIndexChanging Çağrı cihaz düğmelerinden birine tıklandığında, ancak denetim disk belleği işlemini işlemeden önce GridView gerçekleşir. Bu olay genellikle disk belleği işlemini iptal etmek için kullanılır.

Şunlara uygulanır

Ayrıca bkz.