ObjectDataSource.SortParameterName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает имя бизнес-объекта, который позволяет параметру SelectMethod задать выражение сортировки для обеспечения поддержки сортировки источника данных.
public:
property System::String ^ SortParameterName { System::String ^ get(); void set(System::String ^ value); };public string SortParameterName { get; set; }member this.SortParameterName : string with get, setPublic Property SortParameterName As StringЗначение свойства
Имя параметра метода, позволяющее задать параметр, используемый для сортировки данных. Значение по умолчанию - пустая строка.
Примеры
Этот раздел содержит два примера кода. В первом примере кода показано, как реализовать тип, поддерживающий сортировку. Во втором примере кода показано, как реализовать выражение сортировки.
В следующем примере кода показано, как реализовать тип, поддерживающий сортировку. SortingData Класс SelectMethod принимает параметр. sortExpression Передаваемая строка SelectMethod используется для Sort свойства DataView объекта, возвращаемого SelectMethod.
using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
namespace Samples.AspNet.CS
{
public class SortingData
{
public SortingData()
{
}
private static DataTable table;
private DataTable CreateData()
{
table = new DataTable();
table.Columns.Add("Name", typeof(string));
table.Columns.Add("Number", typeof(int));
table.Rows.Add(new object[] { "one", 1 });
table.Rows.Add(new object[] { "two", 2 });
table.Rows.Add(new object[] { "three", 3 });
table.Rows.Add(new object[] { "four", 4 });
return table;
}
public DataView SelectMethod(string sortExpression)
{
table ??= CreateData();
DataView dv = new DataView(table);
dv.Sort = sortExpression;
return dv;
}
}
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls
Namespace Samples.AspNet.VB
Public Class SortingData
Public Sub New()
End Sub
Private Shared table As DataTable
Private Function CreateData() As DataTable
table = New DataTable()
table.Columns.Add("Name", GetType(String))
table.Columns.Add("Number", GetType(Integer))
table.Rows.Add(New Object() {"one", 1})
table.Rows.Add(New Object() {"two", 2})
table.Rows.Add(New Object() {"three", 3})
table.Rows.Add(New Object() {"four", 4})
Return table
End Function
Public Function SelectMethod(ByVal sortExpression As String) As DataView
If table Is Nothing Then
table = CreateData()
End If
Dim dv As New DataView(table)
dv.Sort = sortExpression
Return dv
End Function
End Class
End Namespace
В следующем примере кода показано, как реализовать выражение сортировки. Код на веб-странице создает экземпляр ObjectDataSource элемента управления. Для TypeName свойства задано SortingData значение, а SortParameterName для свойства задано значение sortExpression. Свойству AllowSorting GridView элемента управления присвоено значение true. Когда пользователь нажимает кнопку "Сортировка ", имя Name поля или Numberпередается SelectMethod в параметр сортировки.
<%--<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<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>
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<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>
Комментарии
Свойство SortParameterName используется для поддержки сортировки источников данных. SortExpression Если свойство задано DataSourceSelectArguments для объекта и передается методуSelect, SortParameterName значение определяет имя SelectMethod параметра метода бизнес-объекта, по которому сортируются данные.
Если объект ObjectDataSource связан с элементом управления с привязкой к данным, значения, передаваемые этому параметру, имеют вид значений полей с разделителями-запятыми, за которыми следует "ASC" или "DESC". Например, значение сортировки по возрастанию Name будет "Name ASC"равно .
Свойство SortParameterName делегирует свойству SortParameterName объекта, связанного ObjectDataSourceView с элементом ObjectDataSource управления.