DynamicRouteExpression Class

.NET Framework (current version)

Gets the primary key from the routing information in order to perform data filtering.

Namespace: System.Web.DynamicData
Assembly: System.Web.DynamicData (in System.Web.DynamicData.dll)

Inheritance Hierarchy

System::Object
System.Web.UI.WebControls.Expressions::DataSourceExpression
System.Web.DynamicData::DynamicRouteExpression

Syntax

C++

public ref class DynamicRouteExpression : DataSourceExpression

Constructors

	Name	Description
	DynamicRouteExpression()	Initializes a new instance of the DynamicRouteExpression class.

Properties

	Name	Description
	ColumnName	Gets or sets the name of a column that contains a foreign key that is used to query the data source.
	Context	Gets the HttpContext instance of the owner control.(Inherited from DataSourceExpression.)
	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

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetQueryable(IQueryable^)	Gets the query from the data source..(Overrides DataSourceExpression::GetQueryable(IQueryable^).)
	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^)	Sets the HTTP context of the DynamicRouteExpression object.(Overrides DataSourceExpression::SetContext(Control^, HttpContext^, IQueryableDataSource^).)
	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

	Name	Description
	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.)
	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.)

The DynamicRouteExpression class is used with the QueryExtender control in page markup. The DynamicRouteExpression class gets the primary key from the routing information that is contained in a Web request. The QueryExtender control then uses the key in a Where clause. This modifies the query for the data source, which then returns table rows filtered by the key.

You can also filter data by using a foreign key that you specify using the ColumnName property.

Declarative Syntax

<asp:DynamicRouteExpression
  ColumnName="Name of the foreign key column"/>

Examples

A Visual Studio project with source code is available to accompany this topic: Scaffolding Dynamic Data.

The following example shows a custom List.aspx page template for the Products table. It uses the ColumnName property to specify the ProductCategory foreign key for filtering the Products rows.

The custom List.aspx page displays a column that contains links of the categories that are contained by the ProductCategory foreign-key column. When the user clicks one of these links, the List.aspx page displays only the rows that contain the selected category.

The example requires the following: