GridViewSortEventArgs.SortExpression プロパティとは何？わかりやすく解説 Weblio辞書

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

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

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

GridViewSortEventArgs.SortExpression プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

GridView コントロール内の項目の並べ替えに使用する式を取得または設定します。

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

Visual Basic (宣言)

Public Property SortExpression As
 String

Visual Basic (使用法)

Dim instance As GridViewSortEventArgs
Dim value As String

value = instance.SortExpression

instance.SortExpression = value

public string SortExpression { get;
 set; }

C++

public:
property String^ SortExpression {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_SortExpression ()

/** @property */
public void set_SortExpression (String value)

JScript

public function get SortExpression
 () : String

public function set SortExpression
 (value : String)

プロパティ値
GridView コントロール内の項目の並べ替えに使用する式。

解説

Sorting イベントが発生した場合に、SortExpression プロパティを使用して、並べ替え操作の実行時に GridView コントロールの並べ替えに使用される並べ替え式を確認できます。既定では、GridView コントロールは一度に 1 つの列を並べ替えます。並べ替え式には、単に並べ替えるフィールドの名前が含まれます。プログラムによってこのプロパティにフィールド名のコンマ区切りリストを設定して、一度に複数の列を並べ替えることもできます。

使用例

SortExpression プロパティを使用して、並べ替えを行う GridView コントロール内の列を確認する方法を次の例に示します。ユーザーがアドレス列を並べ替えようとすると、並べ替え操作がキャンセルされます。

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

参照

関連項目
GridViewSortEventArgs クラス
GridViewSortEventArgs メンバ
System.Web.UI.WebControls 名前空間
GridView.AllowSorting プロパティ
GridView.SortExpression プロパティ
GridViewSortEventArgs.SortDirection プロパティ

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

全ての辞書からGridViewSortEventArgs.SortExpression プロパティを検索

>> 「GridViewSortEventArgs.SortExpression プロパティ」を含む用語の索引
GridViewSortEventArgs.SortExpression プロパティのページへのリンク

GridViewSortEventArgs.SortExpression プロパティとは？わかりやすく解説

GridViewSortEventArgs.SortExpression プロパティ

「GridViewSortEventArgs.SortExpression プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

GridViewSortEventArgs.SortExpression プロパティとは？ わかりやすく解説

GridViewSortEventArgs.SortExpression プロパティ

急上昇のことば

「GridViewSortEventArgs.SortExpression プロパティ」の関連用語

GridViewSortEventArgs.SortExpression プロパティとは？わかりやすく解説