GridView.EnableSortingAndPagingCallbacks Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

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

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

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

Boolean

true для использования обратных вызовов на стороне клиента для операций сортировки и разбиения по страницам; falseв противном случае . Значение по умолчанию — false.

Исключения

NotSupportedException

Коллекция 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, возникает исключение.

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

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