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 propriedade TypeName chamando o método identificado pela propriedade SelectMethod e passando valores na coleção 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.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 de dados básica.
Retornos
Uma lista IEnumerable de linhas de dados.
Exceções
O arguments passado para o método ExecuteSelect(DataSourceSelectArguments) especifica que a fonte de dados deve executar algum trabalho adicional enquanto recupera dados para habilitar a paginação ou a classificação dos dados recuperados, mas o controle de fonte de dados não dá suporte à capacidade solicitada.
- ou -
O objeto retornado pelo método ExecuteSelect(DataSourceSelectArguments) não é um DataSet ou DataTable e o cache está habilitado. Apenas os objetos DataSet e DataTable podem ser armazenados em cache para o controle ObjectDataSourceView.
- ou -
A representação de cache e de cliente está habilitada. O ObjectDataSource não será compatível com o cache quando a representação do cliente estiver habilitada.
O objeto retornado pelo método ExecuteSelect(DataSourceSelectArguments) é um DataSet, mas não tem tabelas em sua coleção Tables.
- ou -
A propriedade EnablePaging está definida como true, mas as propriedades StartRowIndexParameterName e MaximumRowsParameterName 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. Os desenvolvedores de páginas e os autores de controle associados a dados não chamam o ExecuteSelect método diretamente; em vez disso, usam 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 e retornado pelo Select método . |
| DataSet | O primeiro DataTable do 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 gerar o Selecting evento. Você pode manipular 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 propriedade e quaisquer SelectMethod 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 gerar o Selected evento. Você pode lidar com esse evento para examinar quaisquer valores retornados e códigos de erro e para executar qualquer pós-processamento.
Se o Select método retornar um DataSet objeto e o cache estiver habilitado, o ObjectDataSourceView recuperará dados de e salvará dados no cache durante a operação. O cache é criado, descartado ou atualizado com base no comportamento de cache especificado pela combinação das CacheDuration propriedades e CacheExpirationPolicy .
Se o Select método retornar um DataSet objeto e uma FilterExpression propriedade tiver sido especificada, ele será avaliado junto com todas 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.
