GridView.EnableSortingAndPagingCallbacks Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define um valor que indica se os retornos de chamada do lado do cliente são usados para as operações de classificação e paginação.

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

Valor da propriedade

Boolean

true para usar retornos de chamada do lado do cliente para as operações de classificação e paginação; caso contrário, false. O padrão é false.

Exceções

NotSupportedException

A coleção Columns contém uma coluna que não dá suporte a retornos de chamada, como TemplateField.

Exemplos

O exemplo a seguir demonstra como usar a EnableSortingAndPagingCallbacks propriedade para habilitar retornos de chamada do lado do cliente para operações de classificação e paginação.


<%@ 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>

Comentários

Por padrão, quando uma operação de classificação ou paginação é executada, o GridView controle retorna para o servidor para executar a operação. Quando a EnableSortingAndPagingCallbacks propriedade é definida como true, um serviço é chamado ao cliente para executar operações de classificação e paginação, o que elimina a necessidade de postar de volta no servidor.

Observação

Nem todos os navegadores dão suporte a esse recurso. Para determinar se um navegador dá suporte a esse recurso, use a SupportsCallback propriedade.

Todas as colunas da coleção devem dar suporte a Columns retornos de chamada para que esse recurso funcione. Se a Columns coleção contiver uma coluna que não dá suporte a retornos de chamada, como TemplateField, uma NotSupportedException exceção será gerada.

Aplica-se a

Partilhar via