GridView.EnableSortingAndPagingCallbacks Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее на использование клиентских ответов при операциях сортировки и разбиения по страницам.
public:
virtual property bool EnableSortingAndPagingCallbacks { bool get(); void set(bool value); };
public virtual bool EnableSortingAndPagingCallbacks { get; set; }
member this.EnableSortingAndPagingCallbacks : bool with get, set
Public 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 Если коллекция содержит столбец, не поддерживающий обратные вызовы, напримерTemplateFieldNotSupportedException, возникает исключение.