ObjectDataSource.SortParameterName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Namens des Geschäftsobjekts, das der SelectMethod Parameter zum Angeben eines Sortierausdrucks für die Unterstützung der Datenquellensortierung verwendet hat.
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 StringEigenschaftswert
Der Name des Methodenparameters, der verwendet wird, um den Parameter anzugeben, der zum Sortieren der Daten verwendet wird. Der Standardwert ist eine leere Zeichenfolge.
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie ein Typ implementiert wird, der die Sortierung unterstützt. Im zweiten Codebeispiel wird veranschaulicht, wie ein Sortierausdruck implementiert wird.
Im folgenden Codebeispiel wird veranschaulicht, wie ein Typ implementiert wird, der die Sortierung unterstützt. Die SelectMethod Klasse SortingData akzeptiert einen Parameter, sortExpression. Die Zeichenfolge, an SelectMethod die übergeben wird, wird für die Sort Eigenschaft des DataView Objekts verwendet, von dem zurückgegeben SelectMethodwird.
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
Im folgenden Codebeispiel wird veranschaulicht, wie ein Sortierausdruck implementiert wird. Der Code auf der Webseite erstellt eine Instanz des ObjectDataSource Steuerelements. Die TypeName Eigenschaft ist auf die Eigenschaft festgelegt SortingData , und die SortParameterName Eigenschaft wird auf sortExpression. Die AllowSorting Eigenschaft des GridView Steuerelements ist auf true. Wenn der Benutzer auf die Schaltfläche "Sortieren" klickt, wird der Feldname oder Numberder Feldname Name im Sortierparameter übergebenSelectMethod.
<%--<%@ 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>
Hinweise
Die SortParameterName Eigenschaft wird verwendet, um die Sortierung von Datenquellen zu unterstützen. Wenn eine SortExpression Eigenschaft für das DataSourceSelectArguments Objekt festgelegt und an die Select Methode übergeben wird, identifiziert der SortParameterName Wert den Parameternamen der SelectMethod Geschäftsobjektmethode, nach der die Daten sortiert werden.
Wenn das ObjectDataSource Steuerelement einem datengebundenen Steuerelement zugeordnet ist, nehmen die an diesen Parameter übergebenen Werte die Form von kommagetrennten Feldwerten gefolgt von "ASC" oder "DESC". Der Wert für eine aufsteigende Sortierung lautet z. B Name"Name ASC". .
Die SortParameterName Eigenschaft delegiert an die SortParameterName Eigenschaft des ObjectDataSourceView Objekts, das dem ObjectDataSource Steuerelement zugeordnet ist.
