DynamicFilterExpression Class
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.
Modifies a database query by using a value from specified filter control.
public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpressionpublic class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpressiontype DynamicFilterExpression = class
inherit DataSourceExpressionPublic Class DynamicFilterExpression
Inherits DataSourceExpression- Inheritance
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
TargetControlIDproperty of the QueryExtender control to reference the data source control.Add a DynamicFilterExpression object as a child of the QueryExtender control.
Set the
ControlIDproperty 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
See also
.NET