SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Método

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parâmetros

arguments

DataSourceSelectArguments

Um objeto DataSourceSelectArguments usado para solicitar operações nos dados além da recuperação de dados básica.

Retornos

IEnumerable

Uma lista IEnumerable de linhas de dados.

Exceções

NotSupportedException

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.

InvalidOperationException

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.

Confira também

• Select(DataSourceSelectArguments)
• SelectParameters
• SelectCommand