Export (0) Print
Expand All

ObjectDataSource.Filtering Event

Occurs before a filter operation.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

'Declaration
Public Event Filtering As ObjectDataSourceFilteringEventHandler
'Usage
Dim instance As ObjectDataSource
Dim handler As ObjectDataSourceFilteringEventHandler

AddHandler instance.Filtering, handler

/** @event */
public void add_Filtering (ObjectDataSourceFilteringEventHandler value)

/** @event */
public void remove_Filtering (ObjectDataSourceFilteringEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.
Not applicable.

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.

NoteNote:

If you are not familiar with the Data Access features in ASP.NET 2.0, you should read some of these topics before continuing:

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

Security noteSecurity Note:

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 handling events, see Consuming Events.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft