AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.