GridView.EnableSortingAndPagingCallbacks 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，该值指示客户端回调是否用于排序和分页操作。
public:
virtual property bool EnableSortingAndPagingCallbacks { bool get(); void set(bool value); };public virtual bool EnableSortingAndPagingCallbacks { get; set; }member this.EnableSortingAndPagingCallbacks : bool with get, setPublic Overridable Property EnableSortingAndPagingCallbacks As Boolean属性值
true 表示客户端回调用于排序和分页操作；否则为 false。 默认值为 false。
例外
Columns 集合包含不支持回发的列，如 TemplateField。
示例
下面的示例演示如何使用 EnableSortingAndPagingCallbacks 属性来启用客户端回调来排序和分页操作。
<%@ 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 EnableSortingAndPagingCallbacks Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView EnableSortingAndPagingCallbacks Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
allowsorting="true"
enablesortingandpagingcallbacks="true"
runat="server">
</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 EnableSortingAndPagingCallbacks Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView EnableSortingAndPagingCallbacks Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
emptydatatext="No data available."
allowpaging="true"
allowsorting="true"
enablesortingandpagingcallbacks="true"
runat="server">
</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>
注解
默认情况下，执行排序或分页操作时， GridView 控件会发回服务器以执行该操作。 EnableSortingAndPagingCallbacks当属性设置为true时，客户端上会调用服务来执行排序和分页操作，这样就无需发回服务器。
备注
并非所有浏览器都支持此功能。 若要确定浏览器是否支持此功能，请使用 SupportsCallback 该属性。
集合中的所有 Columns 列都必须支持此功能正常工作的回调。 Columns如果集合包含不支持回调的列，例如TemplateField引发NotSupportedException异常。