GridViewSortEventArgs.SortDirection Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Richtung ab, in der das GridView-Steuerelement sortiert werden soll, oder legt diese fest.
public:
property System::Web::UI::WebControls::SortDirection SortDirection { System::Web::UI::WebControls::SortDirection get(); void set(System::Web::UI::WebControls::SortDirection value); };public System.Web.UI.WebControls.SortDirection SortDirection { get; set; }member this.SortDirection : System.Web.UI.WebControls.SortDirection with get, setPublic Property SortDirection As SortDirectionEigenschaftswert
Einer der SortDirection-Werte.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die SortDirection -Eigenschaft verwendet wird, um die Richtung zu bestimmen, in der ein GridView Steuerelement sortiert werden soll. Wenn der Benutzer versucht, in absteigender Reihenfolge zu sortieren, wird der Sortiervorgang abgebrochen.
<%@ 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)
{
// By default, the sort order toggles when the user clicks
// the same sort button repeatedly. For this example, cancel
// the sort operation if the user attempts to sort in descending
// order.
if (e.SortDirection == SortDirection.Descending)
{
e.Cancel = true;
Message.Text = "Sorting in descending order is not supported.";
}
else
{
Message.Text = "";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewSortEventArgs SortDirection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewSortEventArgs SortDirection Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
allowpaging="true"
emptydatatext="No data available."
allowsorting="true"
onsorting="CustomersGridView_Sorting"
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">
<script runat="server">
Sub CustomersGridView_Sorting(ByVal sender As Object, ByVal e As GridViewSortEventArgs)
' By default, the sort order toggles when the user clicks
' the same sort button repeatedly. For this example, cancel
' the sort operation if the user attempts to sort in descending
' order.
If e.SortDirection = SortDirection.Descending Then
e.Cancel = True
Message.Text = "Sorting in descending order is not supported."
Else
Message.Text = ""
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewSortEventArgs SortDirection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewSortEventArgs SortDirection Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="true"
allowpaging="true"
emptydatatext="No data available."
allowsorting="true"
onsorting="CustomersGridView_Sorting"
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>
Hinweise
Wenn das Sorting Ereignis ausgelöst wird, können Sie die SortDirection -Eigenschaft verwenden, um die Reihenfolge zu bestimmen, in der das GridView Steuerelement seine Elemente (basierend auf dem Sortierausdruck) sortiert, wenn der Sortiervorgang ausgeführt wird. Da das Sorting Ereignis vor dem Sortiervorgang auftritt, können Sie die SortDirection -Eigenschaft auch verwenden, um die Sortierrichtung programmgesteuert festzulegen.
