ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerablePará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
Lista IEnumerable de filas de datos.
Excepciones
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.
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.
