Comparteix a través de


DataSourceSelectArguments Clase

Definición

Proporciona un mecanismo que utilizan los controles enlazados a datos para solicitar operaciones relacionadas con datos de los controles de origen de datos cuando se recuperan los datos. Esta clase no puede heredarse.

public ref class DataSourceSelectArguments sealed
public sealed class DataSourceSelectArguments
type DataSourceSelectArguments = class
Public NotInheritable Class DataSourceSelectArguments
Herencia
DataSourceSelectArguments

Comentarios

Los controles enlazados a datos usan la DataSourceSelectArguments clase para solicitar que un control de origen de datos realice operaciones adicionales relacionadas con datos en un conjunto de resultados, como ordenar los datos o devolver un subconjunto específico de datos. Estas operaciones relacionadas con los datos se enumeran mediante la DataSourceCapabilities enumeración . En la tabla siguiente se indica cómo la DataSourceSelectArguments clase admite estas operaciones relacionadas con los datos.

Funcionalidad Propiedades relacionadas de DataSourceSelectArguments
DataSourceCapabilities.Sort SortExpression
DataSourceCapabilities.Page StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount RetrieveTotalRowCount, TotalRowCount

Los controles enlazados a datos llaman explícitamente al PerformSelect método para enlazar datos, que llama al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método del control de origen de datos al que están asociados. De este modo, el control enlazado a datos recupera datos del control de origen de datos a petición. Dado que el Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método acepta un DataSourceSelectArguments parámetro, el control enlazado a datos es responsable de crear y administrar un DataSourceSelectArguments objeto y pasarlo al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método cuando recupera datos del control de origen de datos.

En algunos casos, es posible que los controles enlazados a datos no necesiten ninguna funcionalidad adicional relacionada con los datos. En este caso, los controles enlazados a datos pasan un Empty objeto arguments al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método .

En el caso de los conjuntos de resultados ordenados, los controles enlazados a datos comprueban la propiedad de una vista del CanSort origen de datos en tiempo de ejecución y agregan una DataSourceCapabilities.Sort funcionalidad mediante el AddSupportedCapabilities(DataSourceCapabilities) método . Como operación independiente, el control enlazado a datos puede solicitar un conjunto de resultados ordenados de un control de origen de datos estableciendo la SortExpression propiedad en el DataSourceSelectArguments objeto pasado al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método .

Para escenarios de paginación, los controles enlazados a datos comprueban la propiedad de una vista del CanPage origen de datos en tiempo de ejecución y agregan una DataSourceCapabilities.Page funcionalidad mediante el AddSupportedCapabilities(DataSourceCapabilities) método . Como operación independiente, el control enlazado a datos puede solicitar un subconjunto de datos de un control de origen de datos para la paginación estableciendo las StartRowIndex propiedades y MaximumRows en el DataSourceSelectArguments objeto pasado al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método .

Para recuperar un recuento total de filas para escenarios de paginación, los controles enlazados a datos comprueban la propiedad de una vista del CanRetrieveTotalRowCount origen de datos en tiempo de ejecución y agregan una DataSourceCapabilities.RetrieveTotalRowCount funcionalidad mediante el AddSupportedCapabilities(DataSourceCapabilities) método . Como operación independiente, el control enlazado a datos puede solicitar un recuento total de filas de un control de origen de datos para la paginación estableciendo la RetrieveTotalRowCount propiedad en el DataSourceSelectArguments objeto pasado al Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método . Cuando se devuelve el Select(DataSourceSelectArguments, DataSourceViewSelectCallback) método, el recuento total de filas se incluye en la TotalRowCount propiedad .

Importante

Si se establece alguna de las DataSourceSelectArguments propiedades, pero el control de origen de datos enlazado actualmente no admite la funcionalidad solicitada, se produce una InvalidOperationException excepción cuando se llama al DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) método .

Constructores

DataSourceSelectArguments()

Inicializa una nueva instancia predeterminada de la clase DataSourceSelectArguments.

DataSourceSelectArguments(Int32, Int32)

Inicializa una instancia nueva de la clase DataSourceSelectArguments con la posición inicial especificada y el número de filas a devolver para los escenarios de paginación.

DataSourceSelectArguments(String)

Inicializa una instancia nueva de la clase DataSourceSelectArguments con la expresión de ordenación especificada.

DataSourceSelectArguments(String, Int32, Int32)

Inicializa una instancia nueva de la clase DataSourceSelectArguments con la expresión de ordenación, posición inicial y número de filas especificados para devolver para los escenarios de paginación.

Propiedades

Empty

Obtiene un objeto DataSourceSelectArguments con la expresión de ordenación establecida en Empty.

MaximumRows

Obtiene o establece un valor que representa el número máximo de filas de datos que devuelve un control de origen de datos para una operación de recuperación de datos.

RetrieveTotalRowCount

Obtiene o establece un valor que indica si un control de origen de datos debe recuperar un recuento de todas las filas de datos durante una operación de recuperación de datos.

SortExpression

Obtiene o establece una expresión que utiliza la vista de origen de datos para ordenar los datos recuperados por el método Select(DataSourceSelectArguments, DataSourceViewSelectCallback).

StartRowIndex

Obtiene o establece un valor que representa la posición inicial que debe utilizar el control de origen de datos al recuperar filas de datos durante una operación de recuperación de datos.

TotalRowCount

Obtiene o establece el número de filas recuperado durante una operación de recuperación de datos.

Métodos

AddSupportedCapabilities(DataSourceCapabilities)

Agrega una función a la instancia de DataSourceSelectArguments, que se utiliza para comparar funciones compatibles y funciones solicitadas.

Equals(Object)

Determina si la instancia de DataSourceSelectArguments especificada es igual a la instancia actual.

GetHashCode()

Devuelve el código hash para el tipo DataSourceSelectArguments.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)

Compara las funciones solicitadas para una operación ExecuteSelect(DataSourceSelectArguments) con aquéllas que admite la vista de origen de datos especificada.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también