GridView.Sorting イベントとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GridView.Sorting イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

列を並べ替えるハイパーリンクがクリックされた場合に、GridView コントロールが並べ替え操作を処理する前に発生します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Event Sorting As
 GridViewSortEventHandler

Visual Basic (使用法)

Dim instance As GridView
Dim handler As GridViewSortEventHandler

AddHandler instance.Sorting, handler

public event GridViewSortEventHandler Sorting

C++

public:
event GridViewSortEventHandler^ Sorting {
    void add (GridViewSortEventHandler^ value);
    void remove (GridViewSortEventHandler^ value);
}

/** @event */
public void add_Sorting (GridViewSortEventHandler
 value)

/** @event */
public void remove_Sorting (GridViewSortEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

Sorting イベントは、列を並べ替えるためのハイパーリンクがクリックされた場合に、GridView コントロールで並べ替え操作が処理される前に発生します。これにより、このイベントが発生するたびにカスタムルーチン (並べ替え操作をキャンセルするなど) を実行するイベント処理メソッドを提供できます。

GridViewSortEventArgs オブジェクトがイベント処理メソッドに渡されることにより、列の並べ替え式を確認したり、選択操作をキャンセルする必要があることを示したりできます。選択操作をキャンセルするには、GridViewSortEventArgs オブジェクトの Cancel プロパティを true に設定します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

Sorting イベントを使用して、並べ替え操作をキャンセルする方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">
  
  Sub CustomersGridView_Sorting(sender As Object,
 e As GridViewSortEventArgs)
  
    ' Cancel the sorting operation if the user attempts
    ' to sort by address.
    If e.SortExpression = "Address"
 Then
    
      e.Cancel = True
      Message.Text = "You cannot sort by address."
      SortInformationLabel.Text = ""
    
    Else
    
      Message.Text = ""
      
    End If
    
  End Sub

  Sub CustomersGridView_Sorted(ByVal sender
 As Object, ByVal e As
 EventArgs)
 
    ' Display the sort expression and sort direction.
    SortInformationLabel.Text = "Sorting by " &
 _
      CustomersGridView.SortExpression.ToString() & _
      " in " & CustomersGridView.SortDirection.ToString()
 & _
      " order."
    
  End Sub
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView Sorted and 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>

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

<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>
  <body>
    <form 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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
GridView クラス
GridView メンバ
System.Web.UI.WebControls 名前空間
GridViewSortEventArgs
GridView.AllowSorting プロパティ
OnSorting
GridView.Sorted イベント
OnSorted
その他の技術情報
イベントの利用

このページでは「.NET Framework クラスライブラリリファレンス」からGridView.Sorting イベントを検索した結果を表示しています。
Weblioに収録されているすべての辞書からGridView.Sorting イベントを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からGridView.Sorting イベントを検索

>> 「GridView.Sorting イベント」を含む用語の索引
GridView.Sorting イベントのページへのリンク

GridView.Sorting イベントとは？わかりやすく解説

GridView.Sorting イベント

「GridView.Sorting イベント」の関連用語


	© 2025 Microsoft.All rights reserved.

GridView.Sorting イベントとは？ わかりやすく解説

GridView.Sorting イベント

急上昇のことば

「GridView.Sorting イベント」の関連用語

GridView.Sorting イベントとは？わかりやすく解説