SqlDataSourceSelectingEventArgs Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece dados para o Selecting evento do SqlDataSource controlo.
public ref class SqlDataSourceSelectingEventArgs : System::Web::UI::WebControls::SqlDataSourceCommandEventArgspublic class SqlDataSourceSelectingEventArgs : System.Web.UI.WebControls.SqlDataSourceCommandEventArgstype SqlDataSourceSelectingEventArgs = class
inherit SqlDataSourceCommandEventArgsPublic Class SqlDataSourceSelectingEventArgs
Inherits SqlDataSourceCommandEventArgs- Herança
Observações
Ao adicionar um delegado handler de eventos para gerir o Selecting evento, pode realizar qualquer pré-processamento adicional necessário ou cancelar completamente a consulta à base de dados. Como a SqlDataSourceSelectingEventArgs classe é derivada da SqlDataSourceCommandEventArgs classe, pode cancelar uma consulta pendente SqlDataSource à base de dados definindo a Cancel propriedade para true. Pode examinar e manipular as CommandTextpropriedades de consulta à base de dados , Parameters coleção e outras antes de executar a consulta, acedendo ao DbCommand objeto exposto pela Command propriedade. Também pode examinar o DataSourceSelectArguments objeto que é passado para o Select método ao aceder à Arguments propriedade.
A SqlDataSourceSelectingEventArgs classe é usada no OnSelecting método para fornecer acesso a uma SqlDataSource consulta de base de dados antes de esta ser executada.
O SqlDataSource controlo expõe muitos eventos que pode gerir para trabalhar com os objetos de dados subjacentes durante o decorrer de uma operação de dados. A tabela seguinte lista os eventos e as classes associadas EventArgs e os delegados handler de eventos.
| Event | EventArgs | EventHandler |
|---|---|---|
|
Selecting. Ocorre antes de os dados serem recuperados. |
SqlDataSourceSelectingEventArgs | SqlDataSourceSelectingEventHandler |
|
Inserting, Updatinge Deleting. Ocorrem antes de ser realizada uma operação de inserção, atualização ou eliminação. |
SqlDataSourceCommandEventArgs | SqlDataSourceCommandEventHandler |
|
Selected, Inserted, Updated e Deleted. Ocorrem após a conclusão da operação de recuperação, inserção, atualização ou eliminação de dados. |
SqlDataSourceStatusEventArgs | SqlDataSourceStatusEventHandler |
Construtores
| Name | Description |
|---|---|
| SqlDataSourceSelectingEventArgs(DbCommand, DataSourceSelectArguments) |
Inicializa uma nova instância da SqlDataSourceSelectingEventArgs classe, usando o objeto especificado DbCommand e qualquer DataSourceSelectArguments uma passada para o Select(DataSourceSelectArguments) método. |
Propriedades
| Name | Description |
|---|---|
| Arguments |
Faz com que o DataSourceSelectArguments objeto seja passado para o Select(DataSourceSelectArguments) método. |
| Cancel |
Recebe ou define um valor que indica se o evento deve ser cancelado. (Herdado de CancelEventArgs) |
| Command |
Recebe o comando pendente da base de dados. (Herdado de SqlDataSourceCommandEventArgs) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |