SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

  • Referencia

Definición

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

Recupera datos de la base de datos subyacente mediante la cadena SQL 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 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 almacenamiento en caché está habilitado, pero la propiedad DataSourceMode del origen de datos no está establecida en DataSet.

o bien

La propiedad SortParameterName está establecida pero CommandType no está establecida en StoredProcedure.

InvalidOperationException

El origen de datos no puede crear una conexión de base de datos.

o bien

El almacenamiento en caché está habilitado, pero la caché interna y los tipos de comando no coinciden.

Comentarios

La SqlDataSourceView clase implementa el método heredado ExecuteSelect para recuperar datos de una base de datos. 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.

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 recuperar los datos.

Para realizar la operación, el SqlDataSourceView objeto crea un DbCommand objeto mediante el SelectCommand texto y cualquier asociado SelectParameters, y lo ejecuta en la base de datos subyacente. 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, los códigos de error y realizar cualquier procesamiento posterior.

El ExecuteSelect método devuelve un DataView objeto si DataSourceMode se establece DataSeten o en un IDataReader objeto si se establece en DataSourceModeDataReader. Cierre el IDataReader objeto cuando haya terminado de leer los datos.

DataSourceMode Si está establecido DataSet en y el almacenamiento en caché está habilitado, recupera SqlDataSourceView datos de y guarda los datos en la memoria caché durante la operació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 .

Importante

Cuando se usa la suplantación de cliente en autenticación de Windows, los datos se almacenan en caché cuando el primer usuario accede a los datos. Si otro usuario solicita los mismos datos, los datos se recuperan de la memoria caché. Los datos no se recuperan realizando otra llamada a la base de datos para comprobar el acceso del usuario a los datos. Si espera que varios usuarios accedan a los datos y desea que las configuraciones de seguridad de la base de datos comprueben cada recuperación de los datos, no use el almacenamiento en caché.

Si se establece DataSet en DataSourceMode y FilterExpression se ha especificado , se evalúa junto con cualquier proporcionado FilterParameters y el filtro resultante se aplica a la lista de datos durante la operación de recuperación de datos.

Se aplica a

Consulte también