GridView.AllowPaging Özellik
Tanım
Ö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.
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
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 true
ayarlayı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. |