ObjectDataSource.SortParameterName Eigenschaft

Definition

Ruft den Namen des Geschäftsobjekts ab, mit dem der SelectMethod-Parameter einen Sortierausdruck für die Unterstützung der Datenquellensortierung angegeben hat, oder legt diesen fest.

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

Eigenschaftswert

Der Name des Methodenparameters, mit dem der Parameter zum Sortieren der Daten angegeben 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. Der SelectMethod der SortingData -Klasse akzeptiert den Parameter sortExpression. Die an übergebene SelectMethod Zeichenfolge wird für die Sort -Eigenschaft des DataView -Objekts verwendet, das von SelectMethodzurückgegeben wird.

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 -Steuerelements ObjectDataSource . Die TypeName -Eigenschaft ist auf SortingData festgelegt, und die SortParameterName -Eigenschaft ist auf sortExpressionfestgelegt. Die AllowSorting -Eigenschaft des GridView -Steuerelements ist auf truefestgelegt. Wenn der Benutzer auf die Schaltfläche Sortieren klickt, wird der Feldname Name oder Numberim Sortierparameter an übergeben SelectMethod .

<%--<%@ 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 einem ObjectDataSource datengebundenen Steuerelement zugeordnet ist, haben die an diesen Parameter übergebenen Werte die Form von durch Trennzeichen getrennten Feldwerten gefolgt von "ASC" oder "DESC". Der Wert für eine aufsteigende Sortierung für Name wäre "Name ASC"beispielsweise .

Die SortParameterName -Eigenschaft delegiert an die SortParameterName -Eigenschaft des ObjectDataSourceView -Objekts, das dem ObjectDataSource Steuerelement zugeordnet ist.

Gilt für:

Weitere Informationen