• Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • NEW: Design Kits for Figma
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for .NET MAUI UI for Xamarin
    Document Management
    Telerik Document Processing
    Desktop
    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    CMS
    Sitefinity
    UI/UX Design
    Unite UX
    Debugging
    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Jam FiddlerCap FiddlerCore
    Extended Reality
    UI for Unity XR
    Free Tools
    JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

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

CollectionExtensions.ToEnumerable<T>(T)
EnumerableExtensions.ToEnumerable<T>(T)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Install Now
  • Demos
  • SDK Samples Browser
  • Sample Applications
  • Themes Generator
Support Resources
  • Code Library
  • Knowledge Base
  • MVVM Support
  • Videos
  • GitHub SDK Repository
  • System Requirements
Community
  • Forums
  • Blogs
  • XAML Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.