ObjectDataSource.SortParameterName Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nama objek bisnis yang SelectMethod digunakan parameter untuk menentukan ekspresi pengurutan untuk dukungan pengurutan sumber data.
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
Nilai Properti
Nama parameter metode yang digunakan untuk menunjukkan parameter yang digunakan untuk mengurutkan data. Defaultnya adalah string kosong.
Contoh
Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara mengimplementasikan jenis yang mendukung pengurutan. Contoh kode kedua menunjukkan cara mengimplementasikan ekspresi pengurutan.
Contoh kode berikut menunjukkan cara mengimplementasikan jenis yang mendukung pengurutan. Dari SelectMethod
SortingData
kelas mengambil parameter , sortExpression
. String yang diteruskan ke SelectMethod
digunakan untuk Sort properti DataView objek yang dikembalikan oleh 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
Contoh kode berikut menunjukkan cara menerapkan ekspresi pengurutan. Kode di halaman Web membuat instans ObjectDataSource kontrol. Properti TypeName diatur ke SortingData
dan SortParameterName properti diatur ke sortExpression
. Properti AllowSortingGridView kontrol diatur ke true
. Saat pengguna mengklik tombol Urutkan , nama bidang, Name
atau Number
, diteruskan ke SelectMethod
dalam parameter pengurutan.
<%--<%@ 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>
Keterangan
Properti SortParameterName digunakan untuk mendukung pengurutan sumber data. SortExpression Saat properti diatur pada objek dan diteruskan DataSourceSelectArguments ke Select metode , SortParameterName nilai mengidentifikasi nama SelectMethod parameter metode objek bisnis yang sesuai dengan data yang diurutkan.
ObjectDataSource Jika dikaitkan dengan kontrol terikat data, nilai yang diteruskan ke parameter ini mengambil bentuk nilai bidang yang dipisahkan koma diikuti oleh "ASC"
atau "DESC"
. Misalnya, nilai untuk pengurutan Name
naik akan menjadi "Name ASC"
.
Properti SortParameterName mendelegasikan ke SortParameterName properti ObjectDataSourceView objek yang terkait dengan ObjectDataSource kontrol.