Documentation

Class RadExpressionEditor

A control that lets the user input an expression in string form, which it exposes as a LINQ expression.

Inheritance
System.Object
RadExpressionEditor
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Expressions.dll

Syntax

[TelerikToolboxCategory("Data")]
public class RadExpressionEditor : Control, IDisposable

Constructors

RadExpressionEditor()

Initializes a new instance of the RadExpressionEditor class.

Declaration
public RadExpressionEditor()

Fields

ErrorsProperty

Identifies the read-only Errors property.

Declaration
public static readonly DependencyProperty ErrorsProperty
Field Value
System.Windows.DependencyProperty

ExpressionChangedEvent

Identifies the ExpressionChanged routed event.

Declaration
public static readonly RoutedEvent ExpressionChangedEvent
Field Value
System.Windows.RoutedEvent

ExpressionErrorEvent

Identifies the ExpressionError routed event.

Declaration
public static readonly RoutedEvent ExpressionErrorEvent
Field Value
System.Windows.RoutedEvent

ExpressionProperty

Identifies the read-only Expression property.

Declaration
public static readonly DependencyProperty ExpressionProperty
Field Value
System.Windows.DependencyProperty

ExpressionTextProperty

Identifies the ExpressionText property.

Declaration
public static readonly DependencyProperty ExpressionTextProperty
Field Value
System.Windows.DependencyProperty

IsExpressionValidProperty

Identifies the read-only IsExpressionValid property.

Declaration
public static readonly DependencyProperty IsExpressionValidProperty
Field Value
System.Windows.DependencyProperty

IsFieldsDrillDownEnabledProperty

Identifies the IsFieldsDrillDownEnabled property.

Declaration
public static readonly DependencyProperty IsFieldsDrillDownEnabledProperty
Field Value
System.Windows.DependencyProperty

ItemProperty

Identifies the Item property.

Declaration
public static readonly DependencyProperty ItemProperty
Field Value
System.Windows.DependencyProperty

Properties

Errors

Gets the errors from a failed parsing operation.

Declaration
public IEnumerable<ExpressionParserError> Errors { get; }
Property Value
System.Collections.Generic.IEnumerable<ExpressionParserError>

Expression

Gets the LINQ Expression.

Declaration
public Expression Expression { get; }
Property Value
System.Linq.Expressions.Expression

ExpressionText

Gets or sets the expression string.

Declaration
public string ExpressionText { get; set; }
Property Value
System.String

IsExpressionValid

Gets a value indicating whether the string the user has entered is a valid expression.

Declaration
public bool IsExpressionValid { get; }
Property Value
System.Boolean

IsFieldsDrillDownEnabled

Gets or sets a value indicating whether users can drill down into field objects in the Expression editor.

Declaration
public bool IsFieldsDrillDownEnabled { get; set; }
Property Value
System.Boolean

Item

Gets or sets the item the expression will be evaluated against.

Declaration
public object Item { get; set; }
Property Value
System.Object

ViewModel

Gets or sets the view model of the RadExpressionEditor.

Declaration
public ExpressionEditorViewModel ViewModel { get; set; }
Property Value
ExpressionEditorViewModel

Exceptions
System.ArgumentNullException

if value is null.

Methods

add_ExpressionChanged(RadRoutedEventHandler)

Declaration
public void add_ExpressionChanged(RadRoutedEventHandler value)
Parameters
RadRoutedEventHandler value

add_ExpressionError(RadRoutedEventHandler)

Declaration
public void add_ExpressionError(RadRoutedEventHandler value)
Parameters
RadRoutedEventHandler value

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration
public void Dispose()

Dispose(Boolean)

Releases unmanaged and - optionally - managed resources.

Declaration
protected virtual void Dispose(bool disposing)
Parameters
System.Boolean disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources.

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.

Declaration
public override void OnApplyTemplate()

OnCreateAutomationPeer()

When implemented in a derived class, returns class-specific System.Windows.Automation.Peers.AutomationPeer implementations for the automation infrastructure.

Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
System.Windows.Automation.Peers.AutomationPeer

The class-specific System.Windows.Automation.Peers.AutomationPeer subclass to return.

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true internally.

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
System.EventArgs e

The System.Windows.RoutedEventArgs that contains the event data.

remove_ExpressionChanged(RadRoutedEventHandler)

Declaration
public void remove_ExpressionChanged(RadRoutedEventHandler value)
Parameters
RadRoutedEventHandler value

remove_ExpressionError(RadRoutedEventHandler)

Declaration
public void remove_ExpressionError(RadRoutedEventHandler value)
Parameters
RadRoutedEventHandler value

Events

ExpressionChanged

Occurs when the expression changes.

Declaration
public event RadRoutedEventHandler ExpressionChanged
Event Type
RadRoutedEventHandler

ExpressionError

Occurs when an error occurs while parsing an expression.

Declaration
public event RadRoutedEventHandler ExpressionError
Event Type
RadRoutedEventHandler

Extension Methods