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 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParâmetros
- arguments
- DataSourceSelectArguments
Um DataSourceSelectArguments usado para solicitar operações nos dados além da recuperação de dados básica.
Retornos
Uma IEnumerable de linhas de dados.
Exceções
A propriedade DataFile é null ou uma cadeia de caracteres vazia ("").
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.
