AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

Definição

Recupera dados do armazenamento subjacente usando a string SQL na SelectCommand propriedade e quaisquer parâmetros na SelectParameters coleção.

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

A que é usado para solicitar operações sobre os dados para além da DataSourceSelectArguments recuperação básica de dados.

Devoluções

Uma IEnumerable das linhas de dados.

Exceções

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

O arguments método passado ExecuteSelect(DataSourceSelectArguments) especifica que a fonte de dados deve realizar algum trabalho adicional ao recuperar dados para permitir a paginação ou ordenação dos dados recuperados, mas o controlo de fonte de dados não suporta a capacidade solicitada.

Observações

O AccessDataSourceView objeto sobrepõe o ExecuteSelect método para garantir que a DataFile propriedade do seu controlo associado AccessDataSource está definida antes de recuperar os dados.

Antes de o ExecuteSelect método ser realizado, o OnSelecting método é chamado para elevar o Selecting evento. Pode gerir o Selecting evento para examinar os valores dos parâmetros e realizar qualquer pré-processamento antes de uma operação de recuperação de dados.

Para realizar a recuperação dos dados, o AccessDataSourceView objeto constrói um IDbCommand objeto usando o SelectCommand texto e quaisquer propriedades associadas SelectParameters . Depois, o AccessDataSourceView objeto executa o IDbCommand objeto contra o armazenamento de dados subjacente. Após a conclusão da operação, o OnSelected método é chamado para elevar o Selected evento. Pode gerir o Selected evento para examinar quaisquer valores de retorno e códigos de erro e realizar qualquer pós-processamento.

Se a DataSourceMode propriedade estiver definida para o DataSet valor e o cache estiver ativado, recupera AccessDataSourceView dados e guarda os dados na cache durante a operação de recuperação. A cache é criada, descartada ou atualizada, com base no comportamento de cache especificado pela combinação das CacheDuration propriedades e.CacheExpirationPolicy

Se a DataSourceMode propriedade for definida para o DataSet valor e uma FilterExpression propriedade for especificada, a DataSourceMode propriedade é avaliada juntamente com quaisquer propriedades fornecidas FilterParameters e o filtro resultante é aplicado à lista de dados durante a Select operação.

Aplica-se a

Ver também