System.Web.UI.WebControls.ObjectDataSource.Filtering Event

Occurs before a filter operation.


public event ObjectDataSourceFilteringEventHandler Filtering


Handle the ObjectDataSource.Filtering event to perform validation operations on filter parameter values before the System.Web.UI.WebControls.ObjectDataSource control performs a filter operation. You can cancel the selected operation by setting the System.ComponentModel.CancelEventArgs.Cancel property of the System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs to true. The event is raised only if the ObjectDataSource.FilterExpression property is set.

The ObjectDataSource.Filtering event delegates to the ObjectDataSourceView.Filtering event of the System.Web.UI.WebControls.ObjectDataSourceView that is associated with the System.Web.UI.WebControls.ObjectDataSource control.


You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the System.Data.DataSet or System.Data.DataTable object that is returned by the ObjectDataSource.Select method. If you are using the ObjectDataSource.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 handling events, see Consuming Events.


Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions:
Since: .NET 2.0