Exportar (0) Imprimir
Expandir todo

ObjectDataSource.SortParameterName (Propiedad)

Obtiene o establece el nombre del objeto comercial que utilizó el parámetro SelectMethod para especificar una expresión de ordenación para admitir la ordenación del origen de datos.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public string SortParameterName { get; set; }
/** @property */
public String get_SortParameterName ()

/** @property */
public void set_SortParameterName (String value)

public function get SortParameterName () : String

public function set SortParameterName (value : String)

No aplicable.

Valor de propiedad

Nombre del parámetro de método utilizado para indicar el parámetro que se utilizó para ordenar los datos. El valor predeterminado es una cadena vacía.

La propiedad SortParameterName se utiliza para admitir la ordenación del origen de datos. Cuando se establece una propiedad SortExpression del objeto DataSourceSelectArguments y se pasa al método Select, el valor SortParameterName identifica el nombre del parámetro del método de objeto comercial SelectMethod según los datos que se ordenen.

NotaNota:

Si no está familiarizado con las características de acceso a datos en ASP.NET 2.0, debe leer alguno de estos temas antes de continuar:

Si el objeto ObjectDataSource está asociado a un control enlazado a datos, los valores que se pasan a este parámetro tienen el formato de valores de campos separados por comas, seguidos de "ASC" o "DESC". Por ejemplo, el valor en orden ascendente de Name sería "Name ASC".

La propiedad SortParameterName delega en la propiedad SortParameterName del objeto ObjectDataSourceView, que está asociado al control ObjectDataSource.

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo implementar un tipo que admite la ordenación. En el segundo ejemplo se muestra cómo implementar una expresión de ordenación.

En el ejemplo de código siguiente se muestra cómo implementar un tipo que admite la ordenación. El objeto SelectMethod de la clase SortingData toma un parámetro, sortExpression. La propiedad Sort del objeto DataView devuelto por SelectMethod utiliza la cadena que se pasa a 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)
		{
			if (table == null)
			{
				table = CreateData();
			}

			DataView dv = new DataView(table);
			dv.Sort = sortExpression;
			return dv;
		}

	}
}

En el ejemplo de código siguiente se muestra cómo implementar una expresión de ordenación. El código de la página Web crea una instancia del control ObjectDataSource. El valor de la propiedad TypeName se establece en SortingData y el valor de la propiedad SortParameterName se establece en sortExpression. La propiedad AllowSorting del control GridView está establecida en true. Cuando el usuario hace clic en el botón Ordenar, el nombre del campo, Name o Number, se pasa a SelectMethod en el parámetro de ordenación.

<%--<%@ 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>

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft