ObjectDataSource.EnablePaging Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállít egy értéket, amely jelzi, hogy az adatforrás-vezérlő támogatja-e a lekért adatkészlet lapozását.
public:
property bool EnablePaging { bool get(); void set(bool value); };public bool EnablePaging { get; set; }member this.EnablePaging : bool with get, setPublic Property EnablePaging As BooleanTulajdonság értéke
trueha az adatforrás-vezérlő támogatja a lekért adatok lapozását; egyéb esetben. false
Példák
Az alábbi három példa egy weblapot, egy kód mögötti laposztályt és egy adatelérési osztályt mutat be, amely lehetővé teszi, hogy a felhasználó kiválaszthatja, hogy hány rekord jelenjen meg a lapon.
A weblap egy vezérlőelemet ObjectDataSource tartalmaz, amelynek EnablePaging a tulajdonsága a következőre truevan állítva. A SelectCountMethod tulajdonság egy metódus nevére van beállítva, amely a lekérdezésben szereplő rekordok teljes számát adja vissza. A MaximumRowsParameterName tulajdonság és a StartRowIndexParameterName tulajdonság a Select metódusban használt paraméterek nevére van állítva. A lap egy vezérlőt DropDownList is tartalmaz.
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>ObjectDataSource Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
How many rows to display on this page:<br />
<asp:DropDownList
AutoPostBack="true"
ID="rowsToDisplay"
runat="server"
onselectedindexchanged="rowsToDisplay_SelectedIndexChanged">
<asp:ListItem Value="5"></asp:ListItem>
<asp:ListItem Value="10" Selected="True"></asp:ListItem>
<asp:ListItem Value="20"></asp:ListItem>
</asp:DropDownList>
<asp:ObjectDataSource
SelectCountMethod="GetEmployeeCount"
EnablePaging="true"
TypeName="CustomerLogic"
SelectMethod="GetSubsetOfEmployees"
MaximumRowsParameterName="maxRows"
StartRowIndexParameterName="startRows"
ID="ObjectDataSource1"
runat="server">
</asp:ObjectDataSource>
<asp:GridView
DataSourceID="ObjectDataSource1"
AllowPaging="true"
ID="GridView1"
runat="server">
</asp:GridView>
</div>
</form>
</body>
</html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
How many rows to display on this page:<br />
<asp:DropDownList
AutoPostBack="true"
ID="rowsToDisplay"
runat="server"
onselectedindexchanged="rowsToDisplay_SelectedIndexChanged">
<asp:ListItem Value="5"></asp:ListItem>
<asp:ListItem Value="10" Selected="True"></asp:ListItem>
<asp:ListItem Value="20"></asp:ListItem>
</asp:DropDownList>
<asp:ObjectDataSource
SelectCountMethod="GetEmployeeCount"
EnablePaging="true"
TypeName="CustomerLogic"
SelectMethod="GetSubsetOfEmployees"
MaximumRowsParameterName="maxRows"
StartRowIndexParameterName="startRows"
ID="ObjectDataSource1"
runat="server">
</asp:ObjectDataSource>
<asp:GridView
DataSourceID="ObjectDataSource1"
AllowPaging="true"
ID="GridView1"
runat="server">
</asp:GridView>
</div>
</form>
</body>
</html>
A második példa egy kezelőt mutat be a ListControl.SelectedIndexChangedDropDownList vezérlő eseményéhez. A kezelőben lévő kód a PageSize tulajdonságot a felhasználó kiválasztására állítja be.
protected void rowsToDisplay_SelectedIndexChanged(object sender, EventArgs e)
{
GridView1.PageSize = int.Parse(rowsToDisplay.SelectedValue);
}
Protected Sub rowsToDisplay_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles rowsToDisplay.SelectedIndexChanged
GridView1.PageSize = Integer.Parse(rowsToDisplay.SelectedValue)
End Sub
A harmadik példa azt az adatelérési osztályt mutatja be, amely adatokat kér le az Ügyfelek táblából. Tartalmaz egy metódust GetSubsetOfEmployees, amely a SelectMethod vezérlőelem tulajdonságához ObjectDataSource van hozzárendelve. A példa tartalmaz egy metódust GetEmployeeCountis, amely a SelectCountMethod vezérlőelem tulajdonságához ObjectDataSource van rendelve. Az osztály a LINQ használatával kérdezi le az Ügyfelek táblát. A példához linq to SQL osztály szükséges, amely a Northwind adatbázist és az Ügyfelek táblát jelöli. További információ: Hogyan is: LINQ létrehozása SQL-osztályokhoz webes Project.
public class CustomerLogic
{
public List<Customer> GetSubsetOfEmployees(int startRows, int maxRows)
{
NorthwindDataContext ndc = new NorthwindDataContext();
var customerQuery =
from c in ndc.Customers
select c;
return customerQuery.Skip(startRows).Take(maxRows).ToList<Customer>();
}
public int GetEmployeeCount()
{
object cachedCount = HttpRuntime.Cache["TotalEmployeeCount"];
if (cachedCount != null)
{
return int.Parse(cachedCount.ToString());
}
else
{
NorthwindDataContext ndc = new NorthwindDataContext();
var totalNumberQuery =
from c in ndc.Customers
select c;
int employeeCount = totalNumberQuery.Count();
HttpRuntime.Cache.Add("TotalEmployeeCount", employeeCount, null, DateTime.Now.AddMinutes(5), Cache.NoSlidingExpiration, CacheItemPriority.Normal, null);
return employeeCount;
}
}
}
Public Class CustomerLogic
Public Function GetSubsetOfEmployees(ByVal startRows As Integer, ByVal maxRows As Integer) As List(Of Customer)
Dim ndc As New NorthwindDataContext()
Dim customerQuery = _
From c In ndc.Customers _
Select c
Return customerQuery.Skip(startRows).Take(maxRows).ToList()
End Function
Public Function GetEmployeeCount() As Integer
Dim cachedCount = HttpRuntime.Cache("TotalEmployeeCount")
If cachedCount IsNot Nothing Then
Return Integer.Parse(cachedCount.ToString())
Else
Dim ndc As New NorthwindDataContext()
Dim totalNumberQuery = _
From c In ndc.Customers _
Select c
Dim employeeCount = totalNumberQuery.Count()
HttpRuntime.Cache.Add("TotalEmployeeCount", employeeCount, Nothing, DateTime.Now.AddMinutes(5), Cache.NoSlidingExpiration, CacheItemPriority.Normal, Nothing)
Return employeeCount
End If
End Function
End Class
Megjegyzések
A vezérlőelem lapozása az ObjectDataSource üzleti objektumban a megfelelő paraméterekkel rendelkező kiválasztási módszer beállításávalEnablePagingStartRowIndexParameterName, MaximumRowsParameterName valamint SelectCountMethodtulajdonságaival ObjectDataSource kezelhető.
EnablePaging A tulajdonság beállításakor truea SelectParameters gyűjtemény két további paramétert tartalmaz a kért első sorhoz és a kért sorok számához. Ez a két paraméter a tulajdonságok és StartRowIndexParameterName a MaximumRowsParameterName tulajdonságok által meghatározottak szerint van elnevezve. A Select metódusnak a megadott indextől kezdődően a kért sorok számát kell visszaadnia. Mivel előfordulhat, hogy az adatok nem egyenlően oszlanak el az oldal méretével, előfordulhat, hogy az utolsó oldal kevesebb sort tartalmaz. Így a kért sorok száma valójában a visszaadott sorok maximális száma.
Ha a lapozás engedélyezve van a társított adatkötésű vezérlőn, az adatkötésű vezérlő meghívja a Select metódust a kezdőindexkel és a szükséges sorok számával. Emellett ha a SelectCountMethod tulajdonság be van állítva, az adatkötésű vezérlő meghívja a metódust, mielőtt megjelenítené a lapozóvezérlőket. Ha például egy GridView vezérlőelem oldalmérete 5, és a tulajdonság által SelectCountMethod megadott metódus 20 értéket ad vissza, csak 4 oldal jelenik meg a lapozóban.
A EnablePaging tulajdonság az EnablePaging objektum tulajdonságához ObjectDataSourceView delegálható.
