RangeExpression Class (System.Web.UI.WebControls.Expressions)

Switch View :
ScriptFree
.NET Framework Class Library
RangeExpression Class

Provides a way to determine whether a value is greater than or less than a specified value, or whether a value is between two specified values.

Inheritance Hierarchy

System.Object
  System.Web.UI.WebControls.Expressions.DataSourceExpression
    System.Web.UI.WebControls.Expressions.ParameterDataSourceExpression
      System.Web.UI.WebControls.Expressions.RangeExpression

Namespace:  System.Web.UI.WebControls.Expressions
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)
Syntax

Visual Basic
Public Class RangeExpression _
	Inherits ParameterDataSourceExpression
C#
public class RangeExpression : ParameterDataSourceExpression
Visual C++
public ref class RangeExpression : public ParameterDataSourceExpression
F#
type RangeExpression =  
    class
        inherit ParameterDataSourceExpression
    end

The RangeExpression type exposes the following members.

Constructors

  Name Description
Public method RangeExpression Initializes a new instance of the RangeExpression class.
Top
Properties

  Name Description
Protected property Context Gets the HttpContext instance of the owner control. (Inherited from DataSourceExpression.)
Public property DataField Gets or sets the field to use for the comparison.
Public property DataSource Gets the data source object that is associated with the owner control. (Inherited from DataSourceExpression.)
Protected property IsTrackingViewState Gets a value that indicates whether a data source expression object is tracking its view state changes. (Inherited from DataSourceExpression.)
Public property MaxType Gets or sets the maximum value of the range.
Public property MinType Gets or sets the minimum value of the range.
Protected property Owner Gets the owner control. (Inherited from DataSourceExpression.)
Public property Parameters Gets the parameters that are associated with this DataSourceExpression object. (Inherited from ParameterDataSourceExpression.)
Protected property ViewState Gets an instance of the StateBag class that contains the current view state information. (Inherited from DataSourceExpression.)
Top
Methods

  Name Description
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetQueryable Gets the IQueryable object that the range comparison was performed on. (Overrides DataSourceExpression.GetQueryable(IQueryable).)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method LoadViewState Loads the state of the values in the ParameterDataSourceExpression object that must be persisted. (Inherited from ParameterDataSourceExpression.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method SaveViewState Saves the current view state of the ParameterDataSourceExpression object. (Inherited from ParameterDataSourceExpression.)
Public method SetContext Executes the expression by using the specified owner control, context, and data source. (Inherited from ParameterDataSourceExpression.)
Public method SetDirty Marks the DataSourceExpression object so that its state will be saved in view state. (Inherited from DataSourceExpression.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Protected method TrackViewState Tracks view-state changes of the ParameterDataSourceExpression object so that the changes can be stored in the StateBag object for the object. (Inherited from ParameterDataSourceExpression.)
Top
Explicit Interface Implementations

  Name Description
Explicit interface implemetation Private property 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.)
Explicit interface implemetation Private method IStateManager.LoadViewState When implemented by a class, loads the previously saved view state of the data source expression object. (Inherited from DataSourceExpression.)
Explicit interface implemetation Private method IStateManager.SaveViewState When implemented by a class, saves the current view state of the DataSourceExpression object. (Inherited from DataSourceExpression.)
Explicit interface implemetation Private method 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.)
Top
Exceptions

Exception Condition
InvalidOperationException

The DataField property is null.

Remarks

The QueryExtender control provides the ability to filter data in a Web page by using classes in the System.Web.UI.WebControls.Expressions namespace. These classes include the RangeExpression class.

The RangeExpression class searches a data column using a pair of values that define the range. You use the DataField property to specify the column to search. You use the MinType property to specify whether to include or exclude the minimum in the search results, and you use the MaxType property to specify whether to include or exclude the maximum value. The maximum and minimum values can be specified in ASP.NET controls and the values can then be passed to the QueryExtender control as parameters in ControlParameter controls. The results are typically displayed in a data-bound control.

Examples

The following example shows how to search the ListPrice column in the Products table of the AdventureWorks database for products that have a list price in the range that is specified in the FromTextBox and ToTextBox text boxes. The filter includes the minimum value but excludes the maximum value in the results. The results are displayed in a Label control.

This code example is part of a larger example provided in Walkthrough: Filtering Data in a Web Page Using Declarative Syntax.


  <form id="form1" runat="server">

    <asp:TextBox ID="FromTextBox" runat="server"></asp:TextBox>
    <asp:TextBox ID="ToTextBox" runat="server"></asp:TextBox>
    <asp:Button ID="Button1" runat="server" Text="Button" />

    <asp:LinqDataSource ID="LinqDataSource1" 
        ContextTypeName=" FilterDemo.AdventureworksDataContext"  
        runat="server" TableName="Products">
    </asp:LinqDataSource>

    <asp:QueryExtender runat="server"  
        TargetControlID="LinqDataSource1">

    <asp:RangeExpression DataField="ListPrice"  
        MinType="Inclusive" MaxType="Exclusive">
    <asp:ControlParameter ControlID="FromTextBox" />
    <asp:ControlParameter ControlID="ToTextBox" />
    </asp:RangeExpression>
</asp:QueryExtender>

<asp:GridView ID="GridView1" runat="server"    
    DataSourceID="LinqDataSource1" AllowPaging="True" >
</asp:GridView>

</form>


Version Information

.NET Framework

Supported in: 4
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also

Reference

Other Resources