Share via

AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

  • Referência

Definição

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

Recupera dados do armazenamento de dados subjacente usando a cadeia de caracteres SQL na propriedade SelectCommand e quaisquer parâmetros 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 IEnumerable de linhas de dados.

Exceções

InvalidOperationException

A propriedade DataFile é null ou uma cadeia de caracteres vazia ("").

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.

Comentários

O AccessDataSourceView objeto substitui o ExecuteSelect método para garantir que a DataFile propriedade de seu controle associado AccessDataSource seja definida antes de recuperar dados.

Antes que o ExecuteSelect método seja executado, o OnSelecting método é chamado para gerar o Selecting evento. Você pode manipular o Selecting evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma operação de recuperação de dados.

Para executar a recuperação de dados, o AccessDataSourceView objeto cria um IDbCommand objeto usando o SelectCommand texto e quaisquer propriedades associadas SelectParameters . Em seguida, o AccessDataSourceView objeto executa o IDbCommand objeto no armazenamento de dados subjacente. Após a conclusão da operação, o OnSelected método é chamado para gerar o Selected evento. Você pode manipular o Selected evento para examinar quaisquer valores retornados e códigos de erro e executar qualquer pós-processamento.

Se a DataSourceMode propriedade estiver definida como o valor e o DataSet cache estiver habilitado, o recuperará dados AccessDataSourceView de e salvará dados no cache durante a operação de recuperação de dados. O cache é criado, descartado ou atualizado, com base no comportamento de cache especificado pela combinação das CacheDuration propriedades e CacheExpirationPolicy .

Se a DataSourceMode propriedade for definida como o DataSet valor e uma FilterExpression propriedade tiver sido especificada, a DataSourceMode propriedade será avaliada junto com todas as propriedades fornecidas FilterParameters e o filtro resultante será aplicado à lista de dados durante a Select operação.

Aplica-se a

Confira também