Esta documentación está archivada y no tiene mantenimiento.

SqlDataSource.Select (Método)

Recupera los datos de la base de datos subyacente utilizando la cadena SQL SelectCommand y cualquier parámetro que esté en la colección SelectParameters.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public IEnumerable Select (
	DataSourceSelectArguments arguments
)
public IEnumerable Select (
	DataSourceSelectArguments arguments
)
public function Select (
	arguments : DataSourceSelectArguments
) : IEnumerable
No aplicable.

Parámetros

arguments

Objeto DataSourceSelectArguments que se utiliza para solicitar operaciones en los datos después de la recuperación de datos básicos.

Valor devuelto

Una lista IEnumerable de filas de datos.

Tipo de excepciónCondición

InvalidOperationException

El control SqlDataSource no puede establecer una conexión con el origen de datos subyacente.

Se llama al método Select automáticamente durante la fase PreRender del Ciclo de vida de la página. Los controles enlazados a datos asociados a un control SqlDataSource a través de su propiedad DataSourceID llaman este método.

NotaNota:

Si no conoce las características de acceso a datos de ASP.NET 2.0, lea uno o varios de los temas siguientes antes de continuar:

El método Select devuelve un objeto DataView, si la propiedad DataSourceMode está establecida en el valor DataSet, o un objeto IDataReader, si la propiedad DataSourceMode se establece en el valor DataReader. Cierre el objeto IDataReader cuando haya terminado de leer los datos.

Antes de realizarse la operación Select, se llama al método OnSelecting para provocar el evento Selecting. Se puede controlar este evento para que examine los valores de los parámetros y realice cualquier preprocesamiento antes de una operación Select.

Una vez finalizada la operación del método Select, se llama al método OnSelected para provocar el evento Selected. Puede controlar este evento para examinar los valores y códigos de error devueltos, y realizar cualquier procesamiento posterior.

Si se establece la propiedad DataSourceMode en el valor DataSet y está habilitado el almacenamiento en caché, el objeto SqlDataSource recupera y guarda datos en la caché durante la operación Select. La memoria caché se crea, se descarta o se actualiza basándose en el comportamiento del almacenamiento en caché especificado por la combinación de las propiedades CacheDuration y CacheExpirationPolicy.

Nota de seguridadNota: de seguridad

Cuando se está utilizando la suplantación de cliente bajo la autenticación de Microsoft Windows, los datos se almacenan en memoria caché cuando el usuario tiene acceso a ellos por primera vez. Si otro usuario solicita los mismos datos, se recuperarán los datos de la caché. Los datos no se recuperan haciendo otra llamada a la base de datos para comprobar el acceso del usuario a los datos. Si espera que más de un usuario tenga acceso a los datos y desea que cada recuperación de los datos se compruebe mediante las configuraciones de seguridad para la base de datos, no utilice el almacenamiento en caché.

Si se establece la propiedad DataSourceMode en el valor DataSet y se ha especificado una propiedad FilterExpression, se evalúa junto con las propiedades FilterParameters suministradas y el filtro resultante se aplica a la lista de datos durante la operación de Select.

El método Select delega en el método Select del objeto SqlDataSourceView, que está asociado al control SqlDataSource. Para realizar la operación de recuperación de datos, la clase SqlDataSourceView crea un objeto DbCommand utilizando el texto SelectCommand y los valores SelectParameters asociados y, a continuación, ejecuta el comando DbCommand contra la base de datos subyacente.

Nota de seguridadNota: de seguridad

Los valores se insertan en parámetros sin validación, lo que puede suponer una amenaza para la seguridad. Utilice el evento Filtering para validar los valores de los parámetros antes de ejecutar la consulta. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: