Sdílet prostřednictvím

ObjectDataSource.SortParameterName Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví název obchodního objektu SelectMethod , který parametr používá k určení výrazu řazení pro podporu řazení zdroje dat.

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

Hodnota vlastnosti

String

Název parametru metody, který se používá k označení parametru, který se používá k řazení dat. Výchozí hodnota je prázdný řetězec.

Příklady

Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak implementovat typ, který podporuje řazení. Druhý příklad kódu ukazuje, jak implementovat výraz řazení.

Následující příklad kódu ukazuje, jak implementovat typ, který podporuje řazení. SortingData Třída SelectMethod přebírá parametr sortExpression. Řetězec, který se předá do SelectMethod , se používá pro Sort vlastnost objektu DataView , která je vrácena pomocí 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

Následující příklad kódu ukazuje, jak implementovat výraz řazení. Kód na webové stránce vytvoří instanci ObjectDataSource ovládacího prvku. Vlastnost TypeName je nastavená na SortingData a SortParameterName vlastnost je nastavená na sortExpression. Vlastnost AllowSortingGridView ovládacího prvku je nastavena na true. Když uživatel klikne na tlačítko Seřadit, Name předá se SelectMethod do parametru řazení název pole nebo 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>

Poznámky

Vlastnost SortParameterName se používá k podpoře řazení zdrojů dat. SortExpression Když je vlastnost nastavena na DataSourceSelectArguments objekt a předána do Select metody, SortParameterName hodnota identifikuje název parametru SelectMethod obchodní objekt metody, podle kterého jsou data seřazena.

ObjectDataSource Pokud je objekt přidružený k ovládacímu prvku vázanému na data, mají hodnoty předané tomuto parametru podobu hodnot polí oddělených čárkami, za kterými "ASC" následuje nebo "DESC". Například hodnota vzestupného řazení Name podle by byla "Name ASC".

Vlastnost SortParameterName deleguje vlastnost SortParameterName objektu ObjectDataSourceView , který je přidružen k ovládacímu ObjectDataSource prvku.

Platí pro

Viz také