ObjectDataSource.SortParameterName Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja annak az üzleti objektumnak a nevét, amelyet a SelectMethod paraméter az adatforrás-rendezési támogatáshoz használt rendezési kifejezés megadásához használt.
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 StringTulajdonság értéke
Az adatok rendezéséhez használt paramétert jelző metódusparaméter neve. Az alapértelmezett érték egy üres sztring.
Példák
Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan implementálhat olyan típust, amely támogatja a rendezést. A második példakód bemutatja, hogyan implementálhat rendezési kifejezést.
Az alábbi példakód bemutatja, hogyan implementálhat olyan típust, amely támogatja a rendezést.
SelectMethod Az SortingData osztály egy paramétert vesz fel. sortExpression Az átadott SelectMethod sztring a visszaadott Sortobjektum tulajdonságához DataView használatosSelectMethod.
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
Az alábbi példakód bemutatja, hogyan implementálhat rendezési kifejezést. A weblap kódja létrehozza a vezérlő egy példányát ObjectDataSource . A TypeName tulajdonság értéke a következő, SortingData a tulajdonság pedig a SortParameterName következőre sortExpressionvan állítva: . A AllowSorting vezérlő tulajdonsága a GridView következőre truevan állítva: . Amikor a felhasználó a Rendezés gombra kattint, a rendszer átadja Name a mező nevét Number vagy SelectMethodnevét a rendezési paraméterben.
<%--<%@ 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>
Megjegyzések
A SortParameterName tulajdonság az adatforrások rendezésének támogatására szolgál. Ha egy SortExpressionDataSourceSelectArguments tulajdonság az objektumon van beállítva, és átadja a Select metódusnak, az SortParameterName érték azonosítja annak az üzleti objektum metódusnak a SelectMethod paraméternevét, amely szerint az adatok rendezve lesznek.
Ha az ObjectDataSource adatkötésű vezérlőelemhez van társítva, a paraméternek átadott értékek vesszővel tagolt mezőértékek formájában jelennek meg, amelyet vagy "ASC"."DESC" A növekvő rendezés Name értéke például a következő."Name ASC"
A SortParameterName tulajdonság delegálja a SortParameterName vezérlőelemhez társított objektum tulajdonságát ObjectDataSourceViewObjectDataSource .
