Číst v angličtině

Sdílet prostřednictvím

GridViewSortEventArgs Třída

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Poskytuje data pro událost Sorting.

public class GridViewSortEventArgs : System.ComponentModel.CancelEventArgs
Dědičnost
Object
EventArgs
CancelEventArgs
GridViewSortEventArgs

Příklady

Následující příklad ukazuje, jak použít GridViewSortEventArgs objekt předaný do metody zpracování událostí ke zrušení operace řazení, když se uživatel pokusí seřadit sloupec adresy v ovládacím prvku GridView .


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

Poznámky

Ovládací GridView prvek vyvolá Sorting událost, když se klikne na tlačítko Seřadit (tlačítko s jeho CommandName vlastností nastavenou na "Sort"), ale předtím, než GridView ovládací prvek zpracuje operaci řazení. To vám umožní poskytnout metodu zpracování událostí, která provádí vlastní rutinu, například zrušení operace řazení, kdykoli dojde k této události.

Poznámka

Ačkoli jakékoli tlačítko v ovládacím GridView prvku s jeho CommandName vlastností nastavenou na "Sort" vyvolá Sorting událost, tlačítka Seřadit se obvykle zobrazují v řádku GridView záhlaví ovládacího prvku.

Objekt GridViewSortEventArgs je předán metodě zpracování událostí, která umožňuje určit nebo určit výraz řazení a směr řazení, ve kterém se má ovládací prvek seřadit GridView . K určení výrazu řazení použijte SortExpression vlastnost . Pokud chcete určit směr řazení, použijte SortDirection vlastnost . Operaci řazení můžete také zrušit nastavením Cancel vlastnosti na truehodnotu .

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Seznam počátečních hodnot vlastností pro instanci GridViewSortEventArgsnaleznete v konstruktoru GridViewSelectEventArgs .

Konstruktory

GridViewSortEventArgs(String, SortDirection)

Inicializuje novou instanci GridViewSortEventArgs třídy .

Vlastnosti

Cancel

Získá nebo nastaví hodnotu označující, zda má být událost zrušena.

(Zděděno od CancelEventArgs)
SortDirection

Získá nebo nastaví směr, ve kterém se má ovládací prvek seřadit GridView .
SortExpression

Získá nebo nastaví výraz použitý k seřazení položek v ovládacím GridView prvku.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Produkt Verze
.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, 4.8.1

Viz také