ObjectDataSource.SortParameterName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam op van het bedrijfsobject dat door de SelectMethod parameter wordt gebruikt voor het opgeven van een sorteerexpressie voor de ondersteuning voor het sorteren van gegevensbronnen.
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 StringWaarde van eigenschap
De naam van de methodeparameter die wordt gebruikt om de parameter aan te geven die wordt gebruikt om de gegevens te sorteren. De standaardwaarde is een lege tekenreeks.
Voorbeelden
Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u een type implementeert dat ondersteuning biedt voor sorteren. In het tweede codevoorbeeld ziet u hoe u een sorteerexpressie implementeert.
In het volgende codevoorbeeld ziet u hoe u een type implementeert dat ondersteuning biedt voor sorteren. De SelectMethod klasse SortingData heeft een parameter, sortExpression. De tekenreeks waarnaar wordt doorgegeven SelectMethod , wordt gebruikt voor de Sort eigenschap van het DataView object dat wordt geretourneerd door 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
In het volgende codevoorbeeld ziet u hoe u een sorteerexpressie implementeert. Met de code op de webpagina wordt een exemplaar van het ObjectDataSource besturingselement gemaakt. De TypeName eigenschap is ingesteld op SortingData en de SortParameterName eigenschap is ingesteld op sortExpression. De AllowSorting eigenschap van het GridView besturingselement is ingesteld op true. Wanneer de gebruiker op de knop Sorteren klikt, wordt de veldnaam of NameNumber, doorgegeven in SelectMethod de sorteerparameter.
<%--<%@ 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>
Opmerkingen
De SortParameterName eigenschap wordt gebruikt ter ondersteuning van sorteren van gegevensbronnen. Wanneer een SortExpression eigenschap is ingesteld op het DataSourceSelectArguments object en wordt doorgegeven aan de Select methode, identificeert de SortParameterName waarde de parameternaam van de SelectMethod bedrijfsobjectmethode op basis waarvan de gegevens worden gesorteerd.
Als de ObjectDataSource waarde is gekoppeld aan een gegevensgebonden besturingselement, hebben de waarden die aan deze parameter worden doorgegeven, de vorm van door komma's gescheiden veldwaarden gevolgd door "ASC" of "DESC". De waarde voor een oplopende sortering Name zou bijvoorbeeld zijn "Name ASC".
De SortParameterName eigenschap wordt gedelegeerd aan de SortParameterName eigenschap van het ObjectDataSourceView object dat is gekoppeld aan het ObjectDataSource besturingselement.