ObjectDataSource.SortParameterName Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o nome do objeto comercial que o parâmetro SelectMethod usou para especificar uma expressão de classificação para suporte à classificação de fonte de dados.
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 StringValor da propriedade
O nome do parâmetro de método usado para indicar o parâmetro que é usado para classificar os dados. O padrão é uma cadeia de caracteres vazia.
Exemplos
Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como implementar um tipo que dá suporte à classificação. O segundo exemplo de código demonstra como implementar uma expressão de classificação.
O exemplo de código a seguir demonstra como implementar um tipo que dá suporte à classificação. A SelectMethod classe SortingData usa um parâmetro. sortExpression A cadeia de caracteres para a qual SelectMethod é passada é usada para a Sort propriedade do DataView objeto que é retornado por 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
O exemplo de código a seguir demonstra como implementar uma expressão de classificação. O código na página da Web cria uma instância do ObjectDataSource controle. A TypeName propriedade é definida SortingData como e a SortParameterName propriedade é definida como sortExpression. A AllowSorting propriedade do GridView controle está definida como true. Quando o usuário clica no botão Classificar , o nome Name do campo ou Number, é passado para SelectMethod o parâmetro de classificação.
<%--<%@ 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>
Comentários
A SortParameterName propriedade é usada para dar suporte à classificação da fonte de dados. Quando uma SortExpression propriedade é definida no DataSourceSelectArguments objeto e passada para o Select método, o SortParameterName valor identifica o nome do parâmetro do método de objeto empresarial de SelectMethod acordo com o qual os dados são classificados.
Se estiver ObjectDataSource associado a um controle associado a dados, os valores passados para esse parâmetro assumirão a forma de valores de campo separados por vírgula seguidos por "ASC" ou "DESC". Por exemplo, o valor para uma classificação Name crescente seria "Name ASC".
A SortParameterName propriedade delega à SortParameterName propriedade do ObjectDataSourceView objeto associado ao ObjectDataSource controle.