SqlDataSourceSelectingEventArgs Класс

Определение

Предоставляет данные для события Selecting элемента управления SqlDataSource.Provides data for the Selecting event of the SqlDataSource control.

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
Наследование

Комментарии

Добавив делегат обработчика событий для обработки Selecting события, можно выполнить дополнительную предварительную обработку или полностью отменить запрос к базе данных.By adding an event handler delegate to handle the Selecting event, you can perform any additional preprocessing required or cancel the database query entirely. Поскольку SqlDataSourceSelectingEventArgs класс является производным от SqlDataSourceCommandEventArgs класса, можно отменить незавершенный SqlDataSource запрос к базе данных, задав Cancel свойству значение true .Because the SqlDataSourceSelectingEventArgs class is derived from the SqlDataSourceCommandEventArgs class, you can cancel a pending SqlDataSource database query by setting the Cancel property to true. Вы можете проверять CommandText Свойства запросов, коллекций и других баз данных, а также управлять ими Parameters перед выполнением запроса, обращаясь к DbCommand объекту, предоставляемому Command свойством.You can examine and manipulate the CommandText, Parameters collection, and other database query properties prior to running the query by accessing the DbCommand object exposed by the Command property. Также можно проверить DataSourceSelectArguments объект, который передается в Select метод, путем доступа к Arguments свойству.You can also examine the DataSourceSelectArguments object that is passed to the Select method by accessing the Arguments property.

SqlDataSourceSelectingEventArgsКласс используется в OnSelecting методе для предоставления доступа к SqlDataSource запросу базы данных перед его запуском.The SqlDataSourceSelectingEventArgs class is used in the OnSelecting method to provide access to a SqlDataSource database query before it is run.

SqlDataSourceЭлемент управления предоставляет множество событий, которые можно выполнять для работы с базовыми объектами данных в ходе операции с данными.The SqlDataSource control exposes many events that you can handle to work with the underlying data objects during the course of a data operation. В следующей таблице перечислены события и связанные EventArgs классы и делегаты обработчиков событий.The following table lists the events and associated EventArgs classes and event handler delegates.

СобытиеEvent EventArgsEventArgs EventHandlerEventHandler
Selecting.Selecting.

Происходит перед извлечением данных.Occurs before the data is retrieved.
SqlDataSourceSelectingEventArgs SqlDataSourceSelectingEventHandler
Inserting, Updatingи Deleting.Inserting, Updating, and Deleting.

Происходит перед выполнением операции вставки, обновления или удаления.Occur before an insert, update, or delete operation is performed.
SqlDataSourceCommandEventArgs SqlDataSourceCommandEventHandler
Selected, Inserted, Updated и Deleted.Selected, Inserted, Updated, and Deleted.

Происходит после завершения операции извлечения, вставки, обновления или удаления данных.Occur after the data retrieval, insert, update, or delete operation completes.
SqlDataSourceStatusEventArgs SqlDataSourceStatusEventHandler

Конструкторы

SqlDataSourceSelectingEventArgs(DbCommand, DataSourceSelectArguments)

Инициализирует новый экземпляр класса SqlDataSourceSelectingEventArgs, используя указанный объект DbCommand и все объекты DataSourceSelectArguments, переданные методу Select(DataSourceSelectArguments).Initializes a new instance of the SqlDataSourceSelectingEventArgs class, using the specified DbCommand object and any DataSourceSelectArguments passed to the Select(DataSourceSelectArguments) method.

Свойства

Arguments

Получает объект DataSourceSelectArguments, переданный методу Select(DataSourceSelectArguments).Gets the DataSourceSelectArguments object passed to the Select(DataSourceSelectArguments) method.

Cancel

Возвращает или задает значение, показывающее, следует ли отменить событие.Gets or sets a value indicating whether the event should be canceled.

(Унаследовано от CancelEventArgs)
Command

Возвращает команду базы данных, ожидающую выполнение.Gets the pending database command.

(Унаследовано от SqlDataSourceCommandEventArgs)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

См. также раздел