ObjectDataSource.Filtering Event

Definition

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 

Remarks

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

The ObjectDataSource.Filtering event delegates to the ObjectDataSourceView.Filtering event of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Important

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 DataSet or DataTable object that is returned by the Select method. 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.

Applies to

See also