SqlDataSourceSelectingEventArgs Classe
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.
Fornece dados para o Selecting evento do SqlDataSource controle.
public ref class SqlDataSourceSelectingEventArgs : System::Web::UI::WebControls::SqlDataSourceCommandEventArgs
public class SqlDataSourceSelectingEventArgs : System.Web.UI.WebControls.SqlDataSourceCommandEventArgs
type SqlDataSourceSelectingEventArgs = class
inherit SqlDataSourceCommandEventArgs
Public Class SqlDataSourceSelectingEventArgs
Inherits SqlDataSourceCommandEventArgs
- Herança
Comentários
Ao adicionar um representante do manipulador de eventos para manipular o Selecting evento, você pode executar qualquer pré-processamento adicional necessário ou cancelar totalmente a consulta de banco de dados. Como a SqlDataSourceSelectingEventArgs classe é derivada da SqlDataSourceCommandEventArgs classe, você pode cancelar uma consulta de banco de dados pendente definindo SqlDataSource a Cancel propriedade como true. Você pode examinar e manipular a CommandTextcoleção, Parameters e outras propriedades de consulta de banco de dados antes de executar a consulta acessando o DbCommand objeto exposto pela Command propriedade. Você também pode examinar o DataSourceSelectArguments objeto que é passado para o Select método acessando a Arguments propriedade.
A SqlDataSourceSelectingEventArgs classe é usada no OnSelecting método para fornecer acesso a uma SqlDataSource consulta de banco de dados antes de ser executada.
O SqlDataSource controle expõe muitos eventos que você pode manipular para trabalhar com os objetos de dados subjacentes durante uma operação de dados. A tabela a seguir lista os eventos e as classes associadas EventArgs e os delegados do manipulador de eventos.
| Acontecimento | EventArgs | EventHandler |
|---|---|---|
|
Selecting. Ocorre antes que os dados sejam recuperados. |
SqlDataSourceSelectingEventArgs | SqlDataSourceSelectingEventHandler |
|
Inserting, Updatinge Deleting. Ocorre antes que uma operação de inserção, atualização ou exclusão seja executada. |
SqlDataSourceCommandEventArgs | SqlDataSourceCommandEventHandler |
|
Selected, Inserted, Updated e Deleted. Ocorre após a conclusão da operação de recuperação, inserção, atualização ou exclusão de dados. |
SqlDataSourceStatusEventArgs | SqlDataSourceStatusEventHandler |
Construtores
| Nome | Description |
|---|---|
| SqlDataSourceSelectingEventArgs(DbCommand, DataSourceSelectArguments) |
Inicializa uma nova instância da SqlDataSourceSelectingEventArgs classe, usando o objeto especificado DbCommand e qualquer DataSourceSelectArguments um passado para o Select(DataSourceSelectArguments) método. |
Propriedades
| Nome | Description |
|---|---|
| Arguments |
Obtém o DataSourceSelectArguments objeto passado para o Select(DataSourceSelectArguments) método. |
| Cancel |
Obtém ou define um valor que indica se o evento deve ser cancelado. (Herdado de CancelEventArgs) |
| Command |
Obtém o comando de banco de dados pendente. (Herdado de SqlDataSourceCommandEventArgs) |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |