Aracılığıyla paylaş

ObjectDataSource.SortParameterName Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Veri kaynağı sıralama desteği için bir sıralama ifadesi belirtmek için kullanılan parametrenin SelectMethod iş nesnesinin adını alır veya ayarlar.

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

Özellik Değeri

String

Verileri sıralamak için kullanılan parametreyi belirtmek için kullanılan yöntem parametresinin adı. Varsayılan değer boş bir dizedir.

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, sıralamayı destekleyen bir türün nasıl uygulandığını gösterir. İkinci kod örneği, sıralama ifadesinin nasıl uygulanduğunu gösterir.

Aşağıdaki kod örneği, sıralamayı destekleyen bir türün nasıl uygulandığını gösterir. SelectMethod SortingData sınıfının parametresini sortExpressionalır. geçirilen dizeSelectMethod, tarafından SelectMethoddöndürülen nesnesinin DataView özelliği için Sort kullanılır.

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

Aşağıdaki kod örneği, bir sıralama ifadesinin nasıl uygulandığını gösterir. Web sayfasındaki kod, denetimin bir örneğini ObjectDataSource oluşturur. TypeName özelliği olarak SortingDataSortParameterName, özelliği ise olarak sortExpressionayarlanır. Denetimin AllowSortingGridView özelliği olarak trueayarlanır. Kullanıcı Sırala düğmesine tıkladığında, sıralama parametresinde alan adı Name veya Numberöğesine geçirilir 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>

Açıklamalar

SortParameterName özelliği, veri kaynağı sıralamasını desteklemek için kullanılır. nesnesinde DataSourceSelectArguments bir SortExpression özellik ayarlandığında ve yöntemine Select geçirildiğinde, SortParameterName değer verilerin sıralandığı iş nesnesi yönteminin parametre adını SelectMethod tanımlar.

ObjectDataSource veriye bağlı bir denetimle ilişkiliyse, bu parametreye geçirilen değerler virgülle ayrılmış alan değerleri ve ardından "ASC" veya "DESC"biçiminde olur. Örneğin, artan sıralamanın Name değeri olacaktır "Name ASC".

özelliği, SortParameterName denetimle ilişkili nesnenin ObjectDataSourceView özelliğine temsilci SortParameterName atarObjectDataSource.

Şunlara uygulanır

Ayrıca bkz.