Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método ObjectDataSourceView.ExecuteSelect (DataSourceSelectArguments)

 

Recupera dados do objeto que é identificado pelo TypeName propriedade chamando o método que é identificada pelo SelectMethod propriedade e passar os valores no SelectParameters coleção.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

protected internal override IEnumerable ExecuteSelect(
	DataSourceSelectArguments arguments
)

Parâmetros

arguments
Type: System.Web.UI.DataSourceSelectArguments

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

Valor Retornado

Type: System.Collections.IEnumerable

Um IEnumerable lista de linhas de dados.

Exception Condition
NotSupportedException

O arguments passado para o ExecuteSelect método especificar que a fonte de dados deve executar algum trabalho adicional ao recuperar dados para habilitar a paginação ou classificação por meio de dados recuperados, mas o controle da fonte de dados não suporta o recurso solicitado.

- ou -

O objeto retornado pelo ExecuteSelect método não é um DataSet ou DataTable, e o cache está habilitado. Apenas DataSet e DataTable objetos podem ser armazenados em cache para o ObjectDataSourceView controle.

- ou -

Representação de cache e cliente estão habilitados. O ObjectDataSource não oferece suporte a cache quando a representação do cliente está habilitada.

InvalidOperationException

O objeto retornado pelo ExecuteSelect método é um DataSet, mas não tem tabelas seu Tables coleção.

- ou -

O EnablePaging está definida como true, mas o StartRowIndexParameterName e MaximumRowsParameterName propriedades não estão definidas.

O ObjectDataSourceView classe implementa o herdadas ExecuteSelect método para recuperar dados usando um objeto comercial. Os desenvolvedores de páginas e autores de controle ligado a dados não chamar o ExecuteSelect método diretamente; em vez disso, use expostos publicamente Select método.

O método especificado pode ter qualquer assinatura de método, mas deve retornar um dos tipos para o ObjectDataSource controle são listadas 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

A primeira 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 da recuperação de dados é 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 select, o ObjectDataSourceView controle usa reflexão para chamar o método que é identificado pelo SelectMethod propriedade associada parâmetros que estão na SelectParameters coleção e, em seguida, executa. Após a conclusão da operação, o OnSelected método é chamado para gerar o Selected evento. Você pode manipular esse evento para examinar quaisquer valores de retorno e códigos de erro e executar qualquer pós-processamento.

Se o Select método retorna um DataSet objeto e o cache é habilitado, o ObjectDataSourceView recupera e salva os dados em cache durante a operação. O cache é criado, descartados ou atualizados com base no comportamento de cache que é especificado pela combinação da CacheDuration e CacheExpirationPolicy Propriedades.

Se o Select método retorna um DataSet objeto e um FilterExpression propriedade tiver sido especificada, ela é avaliada juntamente com quaisquer fornecido FilterParameters Propriedades e o filtro resultante é aplicada à lista de dados durante o Select operação.

Para obter informações sobre como retornar o número de linhas selecionadas, consulte Select.

.NET Framework
Disponível desde 2.0
Retornar ao início
Mostrar: