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 TypeName propiedad llamando al método identificado por la SelectMethod propiedad y pasando los valores de la SelectParameters colección.
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
que DataSourceSelectArguments se usa para solicitar operaciones en los datos más allá de la recuperación de datos básica.
Devoluciones
Lista IEnumerable de filas de datos.
Excepciones
El arguments que se pasa al ExecuteSelect(DataSourceSelectArguments) método especifica que el origen de datos debe realizar algún trabajo adicional al recuperar datos para habilitar la paginación o la ordenación a través de los datos recuperados, pero el control de origen de datos no admite la funcionalidad solicitada.
O bien
El objeto devuelto por el ExecuteSelect(DataSourceSelectArguments) método no es o DataSetDataTabley el almacenamiento en caché está habilitado. Solo DataSet se pueden almacenar en caché los objetos y DataTable para el ObjectDataSourceView control .
O bien
El almacenamiento en caché y la suplantación de cliente están habilitados. ObjectDataSource no admite el almacenamiento en caché cuando la suplantación de cliente está habilitada.
El objeto devuelto por el ExecuteSelect(DataSourceSelectArguments) método es , DataSetpero no tiene tablas en su Tables colección.
O bien
La EnablePaging propiedad se establece en true, pero las StartRowIndexParameterName propiedades y MaximumRowsParameterName no se establecen.
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 al ExecuteSelect método directamente; en su lugar, usan 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 muestran en la tabla siguiente para llamarlo correctamente.
| Tipo de retorno | Acción |
|---|---|
| IEnumerable | El IEnumerable valor lo devuelve el Select método . |
| DataTable | DataView Se crea mediante y DataTable devuelve el Select método . |
| DataSet | Se extrae la primera DataTable de DataSet y DataView se crea y devuelve el Select método . |
| Object | El objeto se encapsula en un elemento IEnumerable único 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.