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 SelectCommand cadeia de caracteres SQL e todos os parâmetros que estão 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 objeto usado para solicitar operações nos dados além da recuperação básica de dados.
Retornos
Uma IEnumerable lista de linhas de dados.
Exceções
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.
-ou-
O cache está habilitado, mas a DataSourceMode propriedade da fonte de dados não está definida como DataSet.
-ou-
A SortParameterName propriedade está definida, mas CommandType não está definida como StoredProcedure.
A fonte de dados não pode criar uma conexão de banco de dados.
-ou-
O cache está habilitado, mas os tipos de comando e cache interno 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 executa-o 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 lidar com 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 objeto estiver definido como DataSet, ou um IDataReader objeto, se ele DataSourceMode estiver definido como DataReader. Feche o IDataReader objeto quando terminar de ler os dados.
Se estiver DataSourceMode definido DataSet como e o cache estiver habilitado, os SqlDataSourceView dados serão recuperados e salvarão 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 entre as propriedades e CacheExpirationPolicy as CacheDuration propriedades.
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 o cache.
Se estiver DataSourceMode definido DataSet como e um FilterExpression tiver sido especificado, ele será avaliado juntamente com qualquer fornecido FilterParameters e o filtro resultante será aplicado à lista de dados durante a operação de recuperação de dados.