ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera dados do objeto identificado pela TypeName propriedade chamando o método identificado pela SelectMethod propriedade e passando todos os valores na SelectParameters coleção.
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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParâmetros
- arguments
- DataSourceSelectArguments
Um DataSourceSelectArguments usado para solicitar operações nos dados além da recuperação básica de dados.
Retornos
Uma IEnumerable lista de linhas de dados.
Exceções
O arguments método passado para ExecuteSelect(DataSourceSelectArguments) especificar que a fonte de dados deve executar algum trabalho adicional ao recuperar dados para habilitar a paginação ou classificação por meio dos dados recuperados, mas o controle da fonte de dados não dá suporte à funcionalidade solicitada.
- ou -
O objeto retornado pelo ExecuteSelect(DataSourceSelectArguments) método não é um DataSet ou DataTable, e o cache está habilitado. Somente DataSet objetos DataTable podem ser armazenados em cache para o ObjectDataSourceView controle.
- ou -
O cache e a representação do cliente estão habilitados. O ObjectDataSource não dá suporte ao cache quando a representação do cliente está habilitada.
O objeto retornado pelo ExecuteSelect(DataSourceSelectArguments) método é um DataSet, mas não tem tabelas em sua Tables coleção.
- ou -
A EnablePaging propriedade está definida como true, mas as propriedades e MaximumRowsParameterName as StartRowIndexParameterName propriedades não estão definidas.
Comentários
A ObjectDataSourceView classe implementa o método herdado ExecuteSelect para recuperar dados usando um objeto de negócios. Desenvolvedores de páginas e autores de controle associados a dados não chamam o ExecuteSelect método diretamente; em vez disso, use o método exposto Select publicamente.
O método especificado pode ter qualquer assinatura de método, mas deve retornar um dos tipos para o ObjectDataSource controle listado na tabela a seguir para chamá-lo com êxito.
| Tipo de retorno | Ação |
|---|---|
| IEnumerable | O IEnumerable é retornado pelo Select método. |
| DataTable | Um DataView é criado usando o DataTable método e retornado pelo Select método. |
| DataSet | O primeiro DataTable é DataSet extraído e um DataView é criado e retornado pelo Select método. |
| Object | O objeto é encapsulado em um elemento IEnumerable e retornado pelo Select método. |
Antes que a recuperação de dados seja executada, o OnSelecting método é chamado para acionar o Selecting evento. Você pode lidar com esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma operação.
Para executar uma operação de seleção, o ObjectDataSourceView controle usa reflexão para chamar o método identificado pela SelectMethod propriedade e quaisquer parâmetros associados que estejam na coleção e, em SelectParameters seguida, executá-lo. Após a conclusão da operação, o OnSelected método é chamado para acionar o Selected evento. Você pode lidar com esse evento para examinar quaisquer valores retornados e códigos de erro e executar qualquer pós-processamento.
Se o Select método retornar um DataSet objeto e o cache estiver habilitado, os ObjectDataSourceView dados serão recuperados e salvarão dados no cache durante a operação. O cache é criado, descartado ou atualizado com base no comportamento de cache especificado pela combinação das propriedades e do CacheDuration cache CacheExpirationPolicy .
Se o Select método retornar um DataSet objeto e uma FilterExpression propriedade tiver sido especificada, ele será avaliado juntamente com as propriedades fornecidas FilterParameters e o filtro resultante será aplicado à lista de dados durante a Select operação.
Para obter informações sobre como retornar o número de linhas selecionadas, consulte Select.
