ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Recupera datos del objeto identificado por la propiedad TypeName llamando al método identificado por la propiedad SelectMethod y pasando los valores de la colección SelectParameters.

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);
protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);
override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parámetros

arguments
DataSourceSelectArguments

Objeto DataSourceSelectArguments utilizado para solicitar operaciones con los datos que sean más complejas que una recuperación de datos básica.

Devoluciones

IEnumerable

Lista IEnumerable de filas de datos.

Excepciones

NotSupportedException

Los arguments pasados al método ExecuteSelect(DataSourceSelectArguments) especifican que el origen de datos debe realizar algún trabajo adicional durante la recuperación de datos para habilitar la paginación o la clasificación de los datos recuperados, pero el control de origen de datos no admite la función solicitada.

o bien

El objeto devuelto por el método ExecuteSelect(DataSourceSelectArguments) no es un objeto DataSet ni DataTable y el almacenamiento en caché está habilitado. Sólo los objetos DataSet y DataTable se pueden almacenar en caché para el control ObjectDataSourceView.

o bien

Están habilitados tanto el almacenamiento en caché como la suplantación del cliente. El control ObjectDataSource no admite el almacenamiento en caché cuando la suplantación de cliente está habilitada.

InvalidOperationException

El objeto devuelto por el método ExecuteSelect(DataSourceSelectArguments) es un objeto DataSet, pero no tiene tablas en la colección Tables.

o bien

La propiedad EnablePaging está establecida en true, pero no están establecidas las propiedades StartRowIndexParameterName y MaximumRowsParameterName.

Comentarios

La ObjectDataSourceView clase implementa el método heredado ExecuteSelect para recuperar datos mediante un objeto de negocio. Los desarrolladores de páginas y los autores de controles enlazados a datos no llaman directamente al ExecuteSelect método; en su lugar, use el método expuesto Select públicamente.

El método especificado puede tener cualquier firma de método, pero debe devolver uno de los tipos del ObjectDataSource control que se enumeran en la tabla siguiente para llamarlo correctamente.

Tipo de valor devuelto Acción
IEnumerable El método devuelve .IEnumerableSelect
DataTable DataView Se crea mediante DataTable y devuelve el Select método .
DataSet El primero DataTable de DataSet se extrae y DataView se crea y devuelve mediante el Select método .
Object El objeto se encapsula en un elemento IEnumerable uno y lo devuelve el Select método .

Antes de realizar la recuperación de datos, OnSelecting se llama al método para generar el Selecting evento. Puede controlar este evento para examinar los valores de los parámetros y realizar cualquier preprocesamiento antes de una operación.

Para realizar una operación de selección, el ObjectDataSourceView control usa la reflexión para llamar al método identificado por la SelectMethod propiedad y los parámetros asociados que se encuentran en la SelectParameters colección y, a continuación, los ejecuta. Una vez completada la operación, OnSelected se llama al método para generar el Selected evento. Puede controlar este evento para examinar los valores devueltos y los códigos de error, y para realizar cualquier procesamiento posterior.

Si el Select método devuelve un DataSet objeto y el almacenamiento en caché está habilitado, recupera ObjectDataSourceView datos de y guarda los datos en la memoria caché durante la operación. La memoria caché se crea, descarta o actualiza en función del comportamiento de almacenamiento en caché especificado por la combinación de las CacheDuration propiedades y CacheExpirationPolicy .

Si el Select método devuelve un DataSet objeto y se ha especificado una FilterExpression propiedad, se evalúa junto con las propiedades proporcionadas FilterParameters y el filtro resultante se aplica a la lista de datos durante la Select operación.

Para obtener información sobre cómo devolver el número de filas seleccionadas, vea Select.

Se aplica a

Consulte también