Class RadDomainDataSource

Provides an object for loading, filtering, grouping, and sorting data collections.

Inheritance
System.Object
RadDomainDataSource
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.DomainServices.dll

Syntax

[TelerikToolboxCategory("Data")]
public class RadDomainDataSource : Control, ISupportInitialize
Remarks

Use this component to simplify the interaction between the user interface and data from a DomainContext. After specifying a DomainContext and QueryName, the RadDomainDataSource can load data and expose it through the Data and DataView properties. This component also provides codeless integration between other data controls like RadGridView, RadDataPager and RadDataFilter.

Constructors

RadDomainDataSource()

Initializes a new instance of the RadDomainDataSource class.

Declaration
public RadDomainDataSource()

Fields

AutoLoadProperty

Identifies AutoLoad dependency property.

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

CanLoadProperty

Identifies CanLoad dependency property.

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

DomainContextProperty

Identifies DomainContext dependency property.

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

HasChangesProperty

Identifies HasChanges dependency property.

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

IsBusyProperty

Identifies IsBusy dependency property.

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

IsLoadingDataProperty

Identifies IsLoadingData dependency property.

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

IsSubmittingChangesProperty

Identifies IsSubmittingChanges dependency property.

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

LoadDelayProperty

Identifies LoadDelay dependency property.

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

PageSizeProperty

Identifies PageSize dependency property.

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

QueryNameProperty

Identifies QueryName dependency property.

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

QueryParametersProperty

Identifies QueryParameters dependency property.

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

Properties

AutoLoad

Gets or sets a value indicating whether Load is automatically invoked when a change occurs that impacts the query composed by the domain data source.

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

true if the domain data source is will automatically invoke Load when a change occurs that impacts the query composed by the domain data source; otherwise, false.

CancelLoadCommand

Gets the command for cancelling load.

Declaration
public ICommand CancelLoadCommand { get; }
Property Value
System.Windows.Input.ICommand

The command for cancelling load.

CancelSubmitCommand

Gets the command for cancelling submit.

Declaration
public ICommand CancelSubmitCommand { get; }
Property Value
System.Windows.Input.ICommand

The command for cancelling submit.

CanLoad

Gets a value indicating whether the control can perform a load operation based on the present state.

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

true if this instance can load data; otherwise, false.

DataView

Gets the current view of entities resulting from the last load operation, using a DataItemCollection.

Declaration
public DataItemCollection DataView { get; }
Property Value
DataItemCollection

The current view of entities resulting from the last load operation.

DomainContext

Gets or sets the DomainContext instance used for executing the load and submit operations.

Declaration
public DomainContext DomainContext { get; set; }
Property Value
System.ServiceModel.DomainServices.Client.DomainContext

The domain context.
Remarks

This is a dependency property.

FilterDescriptors

Gets the filter descriptors used for filtering operations.

Declaration
public CompositeFilterDescriptorCollection FilterDescriptors { get; }
Property Value
CompositeFilterDescriptorCollection

The filter descriptors.

GroupDescriptors

Gets the sort descriptors used for sorting operations.

Declaration
public GroupDescriptorCollection GroupDescriptors { get; }
Property Value
GroupDescriptorCollection

The filter descriptors.

HasChanges

Gets a value indicating whether the DomainContext currently has any entities with pending changes.

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

true if DomainContext has changes; otherwise, false.

IsBusy

Gets or sets a value indicating whether the domain data source is busy (loading or submitting).

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

true if the domain data source is busy; otherwise, false.

IsLoadingData

Gets a value indicating whether RadDomainDataSource is currently loading data.

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

true if this instance is loading data; otherwise, false.

IsSubmittingChanges

Gets a value indicating whether RadDomainDataSource is currently submitting changes as a result of a call to SubmitChanges().

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

true if this instance is submitting changes; otherwise, false.

LoadCommand

Gets the command for loading data.

Declaration
public ICommand LoadCommand { get; }
Property Value
System.Windows.Input.ICommand

The command for loading data.

LoadDelay

Gets or sets the delay before an automatic data loading operation is started.

Declaration
public TimeSpan LoadDelay { get; set; }
Property Value
System.TimeSpan

The delay before an automatic data loading operation is started.

PageSize

Gets or sets the number of items displayed on each page of the view returned from Data, or 0 to disable paging. A non-zero page size will cause the number of entities loaded with each Load operation to be limited as well, using server-side paging.

Declaration
public int PageSize { get; set; }
Property Value
System.Int32

The size of the page.

QueryName

Gets or sets the name of the query to use for loading.

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

The name of the query to use for loading data.
Remarks

The DomainContext will be searched for a method that returns an EntityQuery, with a name that matches the name provided to QueryName. The matched name can be with or without a "Query" suffix.

QueryParameters

Gets the collection of QueryParameter objects representing arguments of the EntityQuery method specified by the QueryName property.

Declaration
public QueryParameterCollection QueryParameters { get; }
Property Value
QueryParameterCollection

The query parameters.

RejectChangesCommand

Gets the command for rejecting changes.

Declaration
public ICommand RejectChangesCommand { get; }
Property Value
System.Windows.Input.ICommand

The command for rejecting changes.

SortDescriptors

Gets the sort descriptors used for sorting operations.

Declaration
public SortDescriptorCollection SortDescriptors { get; }
Property Value
SortDescriptorCollection

The filter descriptors.

SubmitChangesCommand

Gets the command for submitting changes.

Declaration
public ICommand SubmitChangesCommand { get; }
Property Value
System.Windows.Input.ICommand

The command for submitting changes.

Methods

BeginInit()

Starts the initialization process for this element.

Declaration
public void BeginInit()

CancelLoad()

Cancels the current load operation if any.

Declaration
public void CancelLoad()

CancelSubmit()

Cancels the current submit operation if any.

Declaration
public void CancelSubmit()

EndInit()

Indicates that the initialization process for the element is complete.

Declaration
public void EndInit()
Exceptions
System.InvalidOperationException

Telerik.Windows.Controls.RadDromainDataSource.EndInit was called without Telerik.Windows.Controls.RadDromainDataSource.BeginInit having previously been called on the element.

Load()

Initiates a Load operation if possible.

Declaration
public void Load()

OnLoadedData(LoadedDataEventArgs)

Raises the LoadedData event.

Declaration
protected virtual void OnLoadedData(LoadedDataEventArgs args)
Parameters
LoadedDataEventArgs args

The LoadedDataEventArgs instance containing the event data.

OnLoadingData(LoadingDataEventArgs)

Raises the LoadingData event.

Declaration
protected virtual void OnLoadingData(LoadingDataEventArgs args)
Parameters
LoadingDataEventArgs args

The LoadingDataEventArgs instance containing the event data.

OnPreparedParameterValue(PreparedParameterValueEventArgs)

Raises the PreparedParameterValue event.

Declaration
protected virtual void OnPreparedParameterValue(PreparedParameterValueEventArgs args)
Parameters
PreparedParameterValueEventArgs args

The PreparedParameterValueEventArgs instance containing the event data.

RejectChanges()

Rejects all changes.

Declaration
public void RejectChanges()

SubmitChanges()

Initiates a Submit operation if possible.

Declaration
public void SubmitChanges()

Events

LoadedData

Occurs when a data loading operation is completed.

Declaration
public event EventHandler<LoadedDataEventArgs> LoadedData
Event Type
System.EventHandler<LoadedDataEventArgs>

LoadingData

Occurs when a data loading operation is started.

Declaration
public event EventHandler<LoadingDataEventArgs> LoadingData
Event Type
System.EventHandler<LoadingDataEventArgs>

PreparedParameterValue

Occurs when a query parameter's value is prepared for building the query.

Declaration
public event EventHandler<PreparedParameterValueEventArgs> PreparedParameterValue
Event Type
System.EventHandler<PreparedParameterValueEventArgs>

SubmittedChanges

Event raised whenever a submit operation is completed.

Declaration
public event EventHandler<DomainServiceSubmittedChangesEventArgs> SubmittedChanges
Event Type
System.EventHandler<DomainServiceSubmittedChangesEventArgs>

SubmittingChanges

Event raised whenever a submit operation is launched.

Declaration
public event EventHandler<DomainServiceSubmittingChangesEventArgs> SubmittingChanges
Event Type
System.EventHandler<DomainServiceSubmittingChangesEventArgs>

Extension Methods