ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

Definição

Recupera dados do objeto identificado pela propriedade TypeName chamando o método identificado pela propriedade SelectMethod e passando valores na coleção SelectParameters.

protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);

Parâ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.

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também