SqlDataSourceView.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 banco de dados subjacente usando a cadeia de caracteres SQL SelectCommand e os 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 objeto DataSourceSelectArguments usado para solicitar operações nos dados além da recuperação de dados básica.
Retornos
Uma lista IEnumerable de linhas de dados.
Exceções
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.
- ou -
O cache está habilitado, mas a propriedade DataSourceMode da fonte de dados não está definida como DataSet.
- ou -
A propriedade SortParameterName está definida, mas CommandType não está definido como StoredProcedure.
A fonte de dados não pode criar uma conexão de banco de dados.
- ou -
O cache está habilitado, mas o cache interno e os tipos de comando não correspondem.
Comentários
A SqlDataSourceView classe implementa o método herdado ExecuteSelect para recuperar dados de um banco de dados. Desenvolvedores de páginas e autores de controle associados a dados não chamam o ExecuteSelect método diretamente; em vez disso, use o método exposto Select publicamente.
Antes que a recuperação de dados seja executada, o OnSelecting método é chamado para acionar o Selecting evento. Você pode manipular esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes que os dados sejam recuperados.
Para executar a operação, o SqlDataSourceView objeto cria um DbCommand objeto usando o SelectCommand texto e qualquer associado SelectParameterse o executa no banco de dados subjacente. Após a conclusão da operação, o OnSelected método é chamado para acionar o Selected evento. Você pode manipular esse evento para examinar quaisquer valores retornados, códigos de erro e executar qualquer pós-processamento.
O ExecuteSelect método retornará um DataView objeto se o DataSourceMode estiver definido DataSetcomo ou um IDataReader objeto se o DataSourceMode estiver definido como DataReader. Feche o IDataReader objeto quando terminar de ler os dados.
Se o DataSourceMode estiver definido DataSet como e o cache estiver habilitado, o recuperará dados SqlDataSourceView de e salvará dados no cache durante a operação de dados. O cache é criado, descartado ou atualizado com base no comportamento de cache especificado pela combinação das CacheDuration propriedades e CacheExpirationPolicy .
Importante
Quando você estiver usando a representação do cliente em autenticação do Windows, os dados serão armazenados em cache quando o primeiro usuário acessar os dados. Se outro usuário solicitar os mesmos dados, os dados serão recuperados do cache. Os dados não são recuperados fazendo outra chamada para o banco de dados para verificar o acesso do usuário aos dados. Se você espera que vários usuários acessem os dados e deseja que cada recuperação dos dados seja verificada pelas configurações de segurança do banco de dados, não use cache.
Se o DataSourceMode estiver definido DataSet como e um FilterExpression tiver sido especificado, ele será avaliado junto com qualquer fornecido FilterParameters e o filtro resultante será aplicado à lista de dados durante a operação de recuperação de dados.
