AccessDataSourceView.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 de la base de datos subyacente utilizando la cadena SQL de la propiedad SelectCommand y los parámetros 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 que se utiliza para solicitar operaciones en los datos después de la recuperación de datos básicos.
Devoluciones
Una lista IEnumerable de filas de datos.
Excepciones
La propiedad DataFile es null
o una cadena vacía ("").
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.
Comentarios
El AccessDataSourceView objeto invalida el ExecuteSelect método para asegurarse de que la DataFile propiedad de su control asociado AccessDataSource se establece antes de recuperar datos.
Antes de realizar el ExecuteSelect método , OnSelecting se llama al método para generar el Selecting evento . Puede controlar el Selecting evento para examinar los valores de los parámetros y para realizar cualquier preprocesamiento antes de una operación de recuperación de datos.
Para realizar la recuperación de datos, el AccessDataSourceView objeto crea un IDbCommand objeto mediante el SelectCommand texto y las propiedades asociadas SelectParameters . A continuación, el AccessDataSourceView objeto ejecuta el IDbCommand objeto en el almacenamiento de datos subyacente. Una vez completada la operación, OnSelected se llama al método para generar el Selected evento. Puede controlar el Selected evento para examinar los valores devueltos y los códigos de error y realizar cualquier procesamiento posterior.
Si la DataSourceMode propiedad está establecida en el DataSet valor y el almacenamiento en caché está habilitado, AccessDataSourceView recupera datos de y guarda los datos en la memoria caché durante la operación de recuperación de datos. 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 la DataSourceMode propiedad se establece en el DataSet valor y se ha especificado una FilterExpression propiedad, la DataSourceMode 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.