ObjectDataSource.Filtering Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 Event Type
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.
