AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera dados do armazenamento de dados subjacente usando a cadeia de caracteres 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParâmetros
- arguments
- DataSourceSelectArguments
Um DataSourceSelectArguments que é usado para solicitar operações nos dados além da recuperação básica de dados.
Retornos
Uma IEnumerable das linhas de dados.
Exceções
A DataFile propriedade é ou uma null cadeia de caracteres vazia ("").
O arguments método passado para ExecuteSelect(DataSourceSelectArguments) especificar que a fonte de dados deve executar algum trabalho adicional ao recuperar dados para habilitar a paginação ou classificação por meio dos dados recuperados, mas o controle da fonte de dados não dá suporte à funcionalidade 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 acionar 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, os AccessDataSourceView dados serão recuperados e salvarão 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 propriedades e do CacheDuration cache CacheExpirationPolicy .
Se a DataSourceMode propriedade for definida como o DataSet valor e uma FilterExpression propriedade tiver sido especificada, a DataSourceMode propriedade será avaliada juntamente com as propriedades fornecidas FilterParameters e o filtro resultante será aplicado à lista de dados durante a Select operação.
