ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parâmetros

arguments
DataSourceSelectArguments

Um DataSourceSelectArguments usado para solicitar operações nos dados além da recuperação de dados básica.

Retornos

IEnumerable

Uma lista IEnumerable de linhas de dados.

Exceções

NotSupportedException

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.

InvalidOperationException

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

Confira também