ObjectDataSource.Select 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 almacenamiento de datos subyacente llamando al método identificado por la SelectMethod propiedad con los parámetros de la SelectParameters colección.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableDevoluciones
Lista IEnumerable de filas de datos.
Ejemplos
Para obtener un ejemplo de código, vea ObjectDataSource.
Comentarios
El método especificado puede tener cualquier firma de método, pero debe devolver o derivarse de uno de los tipos enumerados en la tabla siguiente para que el ObjectDataSource control lo llame correctamente.
| Tipo de retorno | Acción |
|---|---|
| IEnumerable | El IEnumerable valor lo devuelve el Select método . |
| DataTable | Se DataView crea mediante y DataTable devuelve el Select método . |
| DataView | El DataView valor lo 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 ajusta en una colección de un elemento IEnumerable y devuelve el Select método . |
El método identificado por la SelectMethod propiedad puede ser un método de instancia o un static método (Shared en Visual Basic). Si es un método de instancia, el objeto de negocio se crea y destruye cada vez que se llama al método especificado por la SelectMethod propiedad , excepto que se usa la misma instancia para llamar al método especificado por la SelectMethod propiedad y el método especificado por la SelectCountMethod propiedad . El Select método devuelve una IEnumerable interfaz. Sin embargo, para habilitar escenarios de filtrado y almacenamiento en caché, el valor devuelto debe ser un DataSet objeto . Aunque la DataSet clase no implementa la IEnumerable interfaz, el ObjectDataSource control extrae automáticamente el control predeterminadoDataView, que implementa .IEnumerable
Antes de realizar la Select operación, 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 realizar cualquier preprocesamiento antes de una Select operación. Para realizar una operación de recuperación de datos, el objeto usa la ObjectDataSourceView reflexión para crear una instancia del objeto identificado por la TypeName propiedad . A continuación, llama al método identificado por la SelectMethod propiedad utilizando las propiedades asociadas SelectParameters . Una vez completada la Select operación, OnSelected se llama al método para generar el Selected evento. Puede controlar el Selected evento para examinar los valores devueltos, los parámetros de salida y las excepciones, y para realizar cualquier procesamiento posterior.
Si la SelectMethod propiedad devuelve un DataSetobjeto , DataTableo DataView y el almacenamiento en caché está habilitado, recupera ObjectDataSource datos de y guarda los datos en la memoria caché durante la Select 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 la SelectMethod propiedad devuelve un DataSet objeto o DataTable y se ha especificado una FilterExpression propiedad, se evalúa con las propiedades proporcionadas FilterParameters y el filtro resultante se aplica a la lista de datos durante la Select operación.
El Select método delega al Select método del ObjectDataSourceView asociado al ObjectDataSource control .
Para obtener más información sobre la combinación de parámetros, la duración del objeto y la resolución de métodos, vea SelectMethod.
Controles de Data-Bound
Cuando el ObjectDataSource control está asociado a un control enlazado a datos, como el GridView control , no es necesario llamar al método desde el Select código de página. El Select control enlazado a datos invoca directamente el método .
