ObjectDataSource.Select Método

Definición

Recupera los datos del almacenamiento de datos subyacente mediante una llamada al método identificado por la propiedad SelectMethod con los parámetros de la colección SelectParameters.

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

Devoluciones

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 valor devuelto Acción
IEnumerable El método devuelve .IEnumerableSelect
DataTable Se DataView crea utilizando DataTable y devuelto por el Select método .
DataView El método devuelve .DataViewSelect
DataSet El primero DataTable de DataSet se extrae y DataView se crea y devuelve mediante el Select método .
Object El objeto se encapsula 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, se crea y destruye el objeto de negocio 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 almacenamiento en caché y filtrado, 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 ObjectDataSourceView objeto usa la 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 que está 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 enlazados a datos

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. En Select su lugar, el control enlazado a datos invoca el método directamente.

Se aplica a

Consulte también