ObjectDataSource.Filtering ObjectDataSource.Filtering ObjectDataSource.Filtering ObjectDataSource.Filtering Event

Определение

Происходит перед операцией фильтрации.Occurs before a filter operation.

public:
 event System::Web::UI::WebControls::ObjectDataSourceFilteringEventHandler ^ Filtering;
public event System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler Filtering;
member this.Filtering : System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler 
Public Custom Event Filtering As ObjectDataSourceFilteringEventHandler 

Комментарии

Обрабатывайте ObjectDataSource событие, чтобы выполнить операции проверки значений параметров фильтра, прежде чем элемент управления выполнит операцию фильтра. FilteringHandle the Filtering event to perform validation operations on filter parameter values before the ObjectDataSource control performs a filter operation. Вы можете отменить выбранную операцию, задав Cancel для trueсвойства объекта значение ObjectDataSourceFilteringEventArgs .You can cancel the selected operation by setting the Cancel property of the ObjectDataSourceFilteringEventArgs to true. Событие возникает только в том случае, FilterExpression если свойство задано.The event is raised only if the FilterExpression property is set.

Событие делегирует ObjectDataSourceView.Filtering к событию ObjectDataSourceView объекта, связанного с ObjectDataSource элементом управления. ObjectDataSource.FilteringThe ObjectDataSource.Filtering event delegates to the ObjectDataSourceView.Filtering event of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Важно!

Необходимо проверить любое значение параметра фильтра, полученное от клиента.You should validate any filter parameter value that you receive from the client. Среда выполнения просто подставляет значение параметра в критерий фильтра и применяет его к DataSet объекту DataTable или Select , возвращаемому методом.The runtime simply substitutes the parameter value into the filter expression and applies it to the DataSet or DataTable object that is returned by the Select method. Если вы используете FilterExpression свойство в качестве меры безопасности для ограничения числа возвращаемых элементов, перед фильтрацией необходимо проверить значения параметров.If you are using the FilterExpression property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about how to handle events, see Handling and Raising Events.

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

Дополнительно