GridView.EnableSortingAndPagingCallbacks Свойство

Определение

Возвращает или задает значение, указывающее на использование клиентских ответов при операциях сортировки и разбиения по страницам.

public virtual bool EnableSortingAndPagingCallbacks { get; set; }

Значение свойства

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>

Комментарии

По умолчанию при выполнении GridView операции сортировки или разбиения по страницам управление отправляется обратно на сервер для выполнения операции. EnableSortingAndPagingCallbacks Если для свойства задано значениеtrue, служба вызывается на клиенте для выполнения операций сортировки и разбиения на страницы, что устраняет необходимость обратной передачи на сервер.

Примечание

Не все браузеры поддерживают эту функцию. Чтобы определить, поддерживает ли браузер эту функцию, используйте SupportsCallback свойство.

Все столбцы в Columns коллекции должны поддерживать обратные вызовы, чтобы эта функция работала. Columns Если коллекция содержит столбец, не поддерживающий обратные вызовы, напримерTemplateFieldNotSupportedException, возникает исключение.

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

См. также раздел