GridView.AllowPaging Özellik

  • Başvuru

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 örnekte, denetimde AllowPaging disk belleği özelliğini bildirimli olarak etkinleştirmek için özelliğinin nasıl kullanılacağı gösterilmektedir 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>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, veri kaynağındaki tüm kayıtları aynı anda görüntülemek yerine kayıtları GridView otomatik olarak sayfalara bölebilir. Veri kaynağı disk belleği özelliğini destekliyorsa, GridView denetim bundan yararlanabilir ve yerleşik disk belleği işlevselliği 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. Disk belleği 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ı denetleyebilirsiniz (disk belleği 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). Ç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.

Mod Açıklama
PagerButton.NextPrevious Önceki ve sonraki düğmelerden oluşan bir dizi sayfalandırma denetimi.
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 bir dizi sayfalandırma denetimi. Bu varsayılan moddur.
PagerButton.NumericFirstLast Numaralandırılmış ve ilk ve son bağlantı düğmelerinden oluşan bir dizi sayfalandırma denetimi.

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

Not

Denetim, GridView veri kaynağı yalnızca bir kayıt sayfası içerdiğinde ç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 bir çağrı satırı şablonu oluşturma hakkında daha fazla bilgi için bkz PagerTemplate. .

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

Olay Açıklama
PageIndexChanged Çağrı aracı 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 Disk belleği 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.