DynamicFilterExpression Class

Reference

Definition

Namespace:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.dll

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.

Modifies a database query by using a value from specified filter control.

public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression

public class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression

type DynamicFilterExpression = class
    inherit DataSourceExpression

Public Class DynamicFilterExpression
Inherits DataSourceExpression

Inheritance: Object

DataSourceExpression
DynamicFilterExpression

Examples

The following example shows how to use the DynamicFilterExpression control to select a filter template in a page. The filter template is selected by the DynamicFilter control that is identified by DynamicFilterExpression control through its ControlID property.

<asp:QueryExtender ID="QueryExtender1"   
    TargetControlID="GridDataSource" runat="server">  
    <asp:DynamicFilterExpression ControlID="CategoryFilterID" />  
</asp:QueryExtender>

Remarks

The DynamicFilterExpression class enables you to modify a database query using the values that are assigned in a DynamicFilter control. This control delegates the task of building of the IQueryable query to a specialized control such as QueryableFilterRepeater control or DynamicFilter control.

The filter controls in turn delegate the building of the query to the filter template that they reference. The query is then executed by the data source control that is referenced by the QueryExtender control.

To use the DynamicFilterExpression class in a page, you follow these steps:

Add a QueryExtender control to the page.
Set the TargetControlID property of the QueryExtender control to reference the data source control.
Add a DynamicFilterExpression object as a child of the QueryExtender control.
Set the ControlID property of the DynamicFilterExpression object to reference the filter control.

In the previous steps it is assumed that the related filter controls, data-bound controls, and data source control are defined in the page.

Constructors

DynamicFilterExpression()

Initializes a new instance of the DynamicFilterExpression class.

Properties

Context	Gets the HttpContext instance of the owner control. (Inherited from DataSourceExpression)
ControlID	Gets or sets the filter control identifier.
DataSource	Gets the data source object that is associated with the owner control. (Inherited from DataSourceExpression)
IsTrackingViewState	Gets a value that indicates whether a data source expression object is tracking its view state changes. (Inherited from DataSourceExpression)
Owner	Gets the owner control. (Inherited from DataSourceExpression)
ViewState	Gets an instance of the StateBag class that contains the current view state information. (Inherited from DataSourceExpression)

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetQueryable(IQueryable)	Gets the modified query using the current filter value.
GetType()	Gets the Type of the current instance. (Inherited from Object)
LoadViewState(Object)	Loads the state of the values in the DataSourceExpression object that must be persisted. (Inherited from DataSourceExpression)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
SaveViewState()	Saves the current view state of the DataSourceExpression object. (Inherited from DataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)	Initializes the expression with data source information.
SetDirty()	Marks the DataSourceExpression object so that its state will be saved in view state. (Inherited from DataSourceExpression)
ToString()	Returns a string that represents the current object. (Inherited from Object)
TrackViewState()	Tracks view state changes of the DataSourceExpression object so that the changes can be stored in the StateBag object for the data source expression object. (Inherited from DataSourceExpression)

Explicit Interface Implementations

IStateManager.IsTrackingViewState	When implemented by a class, gets a value that indicates whether a data source expression object is tracking its view state changes. (Inherited from DataSourceExpression)
IStateManager.LoadViewState(Object)	When implemented by a class, loads the previously saved view state of the data source expression object. (Inherited from DataSourceExpression)
IStateManager.SaveViewState()	When implemented by a class, saves the current view state of the DataSourceExpression object. (Inherited from DataSourceExpression)
IStateManager.TrackViewState()	When implemented by a class, tracks view state changes of the DataSourceExpression object so that the changes can be stored in the StateBag object for the data source expression object. (Inherited from DataSourceExpression)

Applies to