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 evento Selecting do controle SqlDataSource.
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 classes associadas EventArgs e delegados do manipulador de eventos.
Evento | EventArgs | EventHandler |
---|---|---|
Selecting. Ocorre antes que os dados sejam recuperados. |
SqlDataSourceSelectingEventArgs | SqlDataSourceSelectingEventHandler |
Inserting, Updatinge Deleting. Ocorra 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
SqlDataSourceSelectingEventArgs(DbCommand, DataSourceSelectArguments) |
Inicializa uma nova instância da classe SqlDataSourceSelectingEventArgs usando o objeto DbCommand especificado e qualquer DataSourceSelectArguments passado para o método Select(DataSourceSelectArguments). |
Propriedades
Arguments |
Obtém o objeto DataSourceSelectArguments passado para o método Select(DataSourceSelectArguments). |
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
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 Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |