ObjectDataSource.SortParameterName Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę obiektu biznesowego, który SelectMethod parametr używany do określania wyrażenia sortowania dla obsługi sortowania źródła danych.
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 StringWartość właściwości
Nazwa parametru metody używanego do wskazania parametru używanego do sortowania danych. Wartość domyślna to pusty ciąg.
Przykłady
Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak zaimplementować typ obsługujący sortowanie. W drugim przykładzie kodu pokazano, jak zaimplementować wyrażenie sortowania.
W poniższym przykładzie kodu pokazano, jak zaimplementować typ obsługujący sortowanie.
SortingData Klasa SelectMethod przyjmuje parametr sortExpression. Ciąg przekazywany do SelectMethod jest używany dla Sort właściwości DataView obiektu, który jest zwracany przez 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
W poniższym przykładzie kodu pokazano, jak zaimplementować wyrażenie sortowania. Kod na stronie sieci Web tworzy wystąpienie kontrolki ObjectDataSource . Właściwość jest ustawiona TypeName na SortingData , a właściwość jest ustawiona SortParameterName na sortExpressionwartość . Właściwość AllowSorting kontrolki GridView jest ustawiona na true. Gdy użytkownik kliknie przycisk Sortuj , nazwa Name pola lub Number, zostanie przekazana do SelectMethod parametru sortowania.
<%--<%@ 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>
Uwagi
Właściwość SortParameterName jest używana do obsługi sortowania źródła danych. SortExpression Gdy właściwość jest ustawiana na DataSourceSelectArguments obiekcie i przekazywana do Select metody , SortParameterName wartość identyfikuje nazwę parametru metody obiektu biznesowegoSelectMethod, zgodnie z którym dane są sortowane.
ObjectDataSource Jeśli element jest skojarzony z kontrolką powiązaną z danymi, wartości przekazywane do tego parametru mają postać wartości pól rozdzielanych przecinkami, po których "ASC" następuje wartość lub "DESC". Na przykład wartość sortowania Name rosnącego to "Name ASC".
Właściwość SortParameterName deleguje do SortParameterName właściwości obiektu skojarzonego ObjectDataSourceView z kontrolką ObjectDataSource .
