Поделиться через


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, set
Public 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. Свойство AllowSortingGridView элемента управления имеет значение true. Когда пользователь нажимает кнопку Сортировка, Name в параметре сортировки передается SelectMethod имя поля или Number.

<%--<%@ 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, значение определяет имя SelectMethod параметра метода бизнес-объекта, SortParameterName по которому отсортированы данные.

ObjectDataSource Если объект связан с элементом управления с привязкой к данным, значения, передаваемые этому параметру, принимают форму значений полей с разделителями-запятыми, за которыми "ASC" следует или "DESC". Например, значение для сортировки Name по возрастанию будет иметь значение "Name ASC".

Свойство SortParameterName делегирует SortParameterName свойство объекта , связанного ObjectDataSourceView с элементом ObjectDataSource управления .

Применяется к

См. также раздел