ObjectDataSource.SortParameterName プロパティ
アセンブリ: System.Web (system.web.dll 内)

Dim instance As ObjectDataSource Dim value As String value = instance.SortParameterName instance.SortParameterName = value
/** @property */ public String get_SortParameterName () /** @property */ public void set_SortParameterName (String value)
public function get SortParameterName () : String public function set SortParameterName (value : String)
データの並べ替えに使用するパラメータを示すために使用するメソッド パラメータの名前。既定値は空の文字列です。

SortParameterName プロパティは、データ ソースの並べ替えをサポートするために使用されます。DataSourceSelectArguments オブジェクトで SortExpression プロパティが設定され、Select メソッドに渡される場合、SortParameterName 値は、並べ替えるデータに基づいて、SelectMethod ビジネス オブジェクト メソッドのパラメータ名を識別します。
ObjectDataSource がデータ バインド コントロールに関連付けられている場合、このパラメータに渡される値は、"ASC" または "DESC" が後続するコンマ区切りのフィールド値の形式を使用します。たとえば、Name で昇順並べ替えを行う場合の値は "Name ASC" になります。
SortParameterName プロパティは、ObjectDataSource コントロールに関連付けられた ObjectDataSourceView オブジェクトの SortParameterName プロパティに処理を代行させます。

このセクションには、2 つのコード例が含まれています。1 つ目のコード例では、並べ替えをサポートする型を実装する方法を示します。2 つ目のコード例では、並べ替え式を実装する方法を示します。
並べ替えをサポートする型を実装する方法を次のコード例に示します。SortingData クラスの SelectMethod は、sortExpression パラメータを受け取ります。SelectMethod に渡される文字列は、SelectMethod によって返される DataView オブジェクトの Sort プロパティで使用されます。
並べ替え式を実装する方法を次のコード例に示します。Web ページのコードによって、ObjectDataSource コントロールのインスタンスを作成します。TypeName プロパティが SortingData に設定され、SortParameterName プロパティが sortExpression に設定されます。GridView コントロールの AllowSorting プロパティが true に設定されます。ユーザーが [Sort] ボタンをクリックすると、フィールド名である Name または Number が並べ替えパラメータの選択メソッドに渡されます。
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %> <%@ 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"> </script> <html > <head id="Head1" runat="server"> <title>Untitled Page</title> </head> <body> <form id="form1" runat="server"> <div> <asp:GridView ID="GridView1" runat="server" DataSourceID="ObjectDataSource1" AllowSorting="True"> </asp:GridView> <asp:ObjectDataSource ID="ObjectDataSource1" runat="server" SelectMethod="SelectMethod" TypeName="Samples.AspNet.VB.SortingData" SortParameterName="sortExpression"> </asp:ObjectDataSource> </div> </form> </body> </html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %> <%@ 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"> </script> <html > <head id="Head1" runat="server"> <title>Untitled Page</title> </head> <body> <form id="form1" runat="server"> <div> <asp:GridView ID="GridView1" runat="server" DataSourceID="ObjectDataSource1" AllowSorting="True"> </asp:GridView> <asp:ObjectDataSource ID="ObjectDataSource1" runat="server" SelectMethod="SelectMethod" TypeName="Samples.AspNet.CS.SortingData" SortParameterName="sortExpression"> </asp:ObjectDataSource> </div> </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- ObjectDataSource.SortParameterName プロパティのページへのリンク