ControlFilterExpression 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 the data key of the item that is selected in a data-bound control.

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

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

type ControlFilterExpression = class
    inherit DataSourceExpression

Public Class ControlFilterExpression
Inherits DataSourceExpression

Inheritance: Object

DataSourceExpression
ControlFilterExpression

Examples

The following example shows how to use the ControlFilterExpression class to reference a source data-bound control, where the data key is selected. The QueryExtender control points to a target data source control that obtains data that is filtered by using the selected data key. In the example, the source data-bound control references a parent table and the target data-bound control references a child table.

<asp:QueryExtender ID="QueryExtenderID"   
    TargetControlID="TargetDataSourceID" runat="server">  
    <asp:ControlFilterExpression ControlID="SourceGridViewID" />  
</asp:QueryExtender>

Remarks

The ControlFilterExpression class that is designed to be used when a page contains two data-bound controls such as a GridView control and a ListView control. One control is the source, where a data key (row) is selected. The other control is the target where the data is displayed based on the selected data key. The target data is obtained by a data source control that executes the query that is defined in the QueryExtender class and that is built by using the selected data key.

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

Add the QueryExtender control to the page.
Set the TargetControlID property of the QueryExtender control to the ID of the target data source control.
Add a ControlFilterExpression instance to the QueryExtender control.
Set the ControlID property of the ControlFilterExpression element to the source data-bound control.

Constructors

ControlFilterExpression()

Initializes a new instance of the ControlFilterExpression class.

Properties

Column	Gets or sets the name of the column that the query is based on.
Context	Gets the HttpContext instance of the owner control. (Inherited from DataSourceExpression)
ControlID	Gets or sets the ID of the source data-bound control.
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 data source query to modify.
GetType()	Gets the Type of the current instance. (Inherited from Object)
LoadViewState(Object)	Restores the previously saved view state.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
SaveViewState()	Saves the changes to view state since the time the page was posted to the server.
SetContext(Control, HttpContext, IQueryableDataSource)	Initializes the filter 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()	Causes the ControlFilterExpression object to track changes to its view state so they can be stored in the control's view state object and to be persisted across requests for the same page.

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

Share via