Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe GridViewSortEventArgs

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Fornece dados para o evento de Sorting .

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.EventArgs
    System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.GridViewSortEventArgs

public class GridViewSortEventArgs : CancelEventArgs

NomeDescrição
System_CAPS_pubmethodGridViewSortEventArgs(String, SortDirection)

Inicializa uma nova instância da classe GridViewSortEventArgs.

NomeDescrição
System_CAPS_pubpropertyCancel

Obtém ou define um valor que indica se o evento deve ser cancelado.(Herdado de CancelEventArgs.)

System_CAPS_pubpropertySortDirection

Obtém ou define a direção na qual o controle GridView será classificado.

System_CAPS_pubpropertySortExpression

Obtém ou define a expressão usada para classificar os itens no controle GridView.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

O GridView controlar gera o Sorting evento quando um botão de classificação (um botão com sua CommandName propriedade definida como "Classificar") é clicado, mas antes de GridView controle manipula a operação de classificação. Isso permite que você forneça um método de manipulação de eventos que executa uma rotina personalizada, como cancelar a operação de classificação, sempre que esse evento ocorre.

System_CAPS_noteObservação

Embora qualquer botão dentro de um GridView controlar com seu CommandName propriedade definida como "Classificar" irá gerar o Sorting eventos, geralmente aparecem botões de classificação na linha de cabeçalho de um GridView controle.

Um GridViewSortEventArgs objeto é passado para o método de manipulação de eventos, que permite que você especificar ou determinar a classificação de direção de classificação e de expressão na qual classificar o GridView controle. Para determinar a expressão de classificação, use o SortExpression propriedade. Para determinar a direção de classificação, use o SortDirection propriedade. Você também pode cancelar uma operação de classificação, definindo o Cancel propriedade true.

Para obter mais informações sobre a manipulação de eventos, consulte NIB: consumindo eventos.

Para obter uma lista de valores de propriedade inicial para uma instância do GridViewSortEventArgs, consulte o GridViewSelectEventArgs construtor.

O exemplo a seguir demonstra como usar o GridViewSortEventArgs objeto passado para o método de manipulação de eventos para cancelar a operação de classificação quando o usuário tentar classificar a coluna de endereço em um GridView controle.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_Sorting(Object sender, GridViewSortEventArgs e)
  {
    // Cancel the sorting operation if the user attempts
    // to sort by address.
    if (e.SortExpression == "Address")
    {
      e.Cancel = true;
      Message.Text = "You cannot sort by address.";
      SortInformationLabel.Text = "";
    }
    else
    {
      Message.Text = "";
    }
  }

  void CustomersGridView_Sorted(Object sender, EventArgs e)
  {
    // Display the sort expression and sort direction.
    SortInformationLabel.Text = "Sorting by " +
      CustomersGridView.SortExpression.ToString() +
      " in " + CustomersGridView.SortDirection.ToString() +
      " order.";
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView Sorting Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView Sorting Example</h3>

      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>

      <br/>

      <asp:label id="SortInformationLabel"
        forecolor="Navy"
        runat="server"/>

      <br/>  

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        allowpaging="true"
        emptydatatext="No data available." 
        allowsorting="true"
        onsorting="CustomersGridView_Sorting"
        onsorted="CustomersGridView_Sorted"  
        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>

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: