DomainDataSource Class
WCF RIA Services
[WCF RIA Services Version 1 Service Pack 2 is compatible with either .NET framework 4 or .NET Framework 4.5, and with either Silverlight 4 or Silverlight 5.]
Provides an object for loading, filtering, grouping, and sorting data collections.
System.Object
System.Windows.DependencyObject
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.DomainDataSource
System.Windows.DependencyObject
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.DomainDataSource
Namespace: System.Windows.Controls
Assembly: System.Windows.Controls.DomainServices (in System.Windows.Controls.DomainServices.dll)
[TemplateVisualStateAttribute(Name = "Unchanged", GroupName = "ChangeStates")] [TemplateVisualStateAttribute(Name = "Changed", GroupName = "ChangeStates")] [TemplateVisualStateAttribute(Name = "Normal", GroupName = "CommonStates")] [TemplateVisualStateAttribute(Name = "Disabled", GroupName = "CommonStates")] [TemplateVisualStateAttribute(Name = "Idle", GroupName = "ActivityStates")] [TemplateVisualStateAttribute(Name = "Loading", GroupName = "ActivityStates")] [TemplateVisualStateAttribute(Name = "Submitting", GroupName = "ActivityStates")] public class DomainDataSource : Control
The DomainDataSource type exposes the following members.
| Name | Description | |
|---|---|---|
|
ActualHeight | (Inherited from FrameworkElement.) |
|
|
ActualWidth | (Inherited from FrameworkElement.) |
|
|
AllowDrop | (Inherited from UIElement.) |
|
|
AutoLoad | Gets or sets a value indicating whether Load is automatically invoked when a change occurs that impacts the query composed by the DomainDataSource. |
|
|
Background | (Inherited from Control.) |
|
|
BorderBrush | (Inherited from Control.) |
|
|
BorderThickness | (Inherited from Control.) |
|
|
CacheMode | (Inherited from UIElement.) |
|
|
CanLoad | Gets a value indicating whether the control can perform a load operation based on the present state. |
|
|
Clip | (Inherited from UIElement.) |
|
|
Cursor | (Inherited from FrameworkElement.) |
|
|
Data | Gets the entities resulting from the last load operation, as an IEnumerable. |
|
|
DataContext | (Inherited from FrameworkElement.) |
|
|
DataView | Gets the current view of entities resulting from the last load operation, using a DomainDataSourceView. |
|
DefaultStyleKey | (Inherited from Control.) |
|
|
DesignData | Gets or sets the data to use at design time. |
|
|
DesiredSize | (Inherited from UIElement.) |
|
|
Dispatcher | (Inherited from DependencyObject.) |
|
|
DomainContext | Gets or sets the DomainContext instance used for executing the load and submit operations. |
|
|
FilterDescriptors | Gets the collection of FilterDescriptor objects used when performing loads. |
|
|
FilterOperator | Gets or sets the logical operator used for combining FilterDescriptor objects in the filters collection. |
|
|
FlowDirection | (Inherited from FrameworkElement.) |
|
|
FontFamily | (Inherited from Control.) |
|
|
FontSize | (Inherited from Control.) |
|
|
FontStretch | (Inherited from Control.) |
|
|
FontStyle | (Inherited from Control.) |
|
|
FontWeight | (Inherited from Control.) |
|
|
Foreground | (Inherited from Control.) |
|
|
GroupDescriptors | Gets the collection of grouping objects that are used to organize the data into groups. |
|
|
HasChanges | Gets a value indicating whether the items exposed by this DomainDataSource have pending changes. |
|
|
Height | (Inherited from FrameworkElement.) |
|
|
HorizontalAlignment | (Inherited from FrameworkElement.) |
|
|
HorizontalContentAlignment | (Inherited from Control.) |
|
|
IsBusy | Gets a value indicating whether this DomainDataSource is loading data or submitting changes. |
|
|
IsEnabled | (Inherited from Control.) |
|
|
IsHitTestVisible | (Inherited from UIElement.) |
|
|
IsLoadingData | Gets a value indicating whether the DomainDataSource is currently loading data. |
|
|
IsSubmittingChanges | Gets a value indicating whether the DomainDataSource is currently submitting changes as a result of a call to SubmitChanges. |
|
|
IsTabStop | (Inherited from Control.) |
|
|
Language | (Inherited from FrameworkElement.) |
|
|
LoadCommand | Gets an ICommand that invokes Load on this DomainDataSource. |
|
|
LoadDelay | Gets or sets the delay before an automatic data loading operation is started. |
|
|
LoadInterval | Gets or sets the duration between two successive data loading operations in a progressive data loading scenario. |
|
|
LoadSize | Gets or sets the maximum number of items to load each time a Load is executed. When equal to 0, all requested entities will be loaded. |
|
|
Margin | (Inherited from FrameworkElement.) |
|
|
MaxHeight | (Inherited from FrameworkElement.) |
|
|
MaxWidth | (Inherited from FrameworkElement.) |
|
|
MinHeight | (Inherited from FrameworkElement.) |
|
|
MinWidth | (Inherited from FrameworkElement.) |
|
|
Name | (Inherited from FrameworkElement.) |
|
|
Opacity | (Inherited from UIElement.) |
|
|
OpacityMask | (Inherited from UIElement.) |
|
|
Padding | (Inherited from Control.) |
|
|
PageSize | Gets or sets the number of items displayed on each page of the view returned from the Data and DataView properties, or 0 to disable paging. |
|
|
Parent | (Inherited from FrameworkElement.) |
|
|
Projection | (Inherited from UIElement.) |
|
|
QueryName | Gets or sets the name of the query to use for loading. |
|
|
QueryParameters | Gets the collection of Parameter objects representing arguments of the EntityQuery<TEntity> method specified by the QueryName property. |
|
|
RefreshInterval | Gets or sets the interval between automatic Load operations to refresh the data with any changes that may have occurred on the server. |
|
|
RejectChangesCommand | Gets an ICommand that invokes RejectChanges on this DomainDataSource. |
|
|
RenderSize | (Inherited from UIElement.) |
|
|
RenderTransform | (Inherited from UIElement.) |
|
|
RenderTransformOrigin | (Inherited from UIElement.) |
|
|
Resources | (Inherited from FrameworkElement.) |
|
|
SortDescriptors | Gets the collection of sort descriptor objects that are used to sort the data. |
|
|
Style | (Inherited from FrameworkElement.) |
|
|
SubmitChangesCommand | Gets an ICommand that invokes SubmitChanges on this DomainDataSource. |
|
|
TabIndex | (Inherited from Control.) |
|
|
TabNavigation | (Inherited from Control.) |
|
|
Tag | (Inherited from FrameworkElement.) |
|
|
Template | (Inherited from Control.) |
|
|
Triggers | (Inherited from FrameworkElement.) |
|
|
UseLayoutRounding | (Inherited from UIElement.) |
|
|
VerticalAlignment | (Inherited from FrameworkElement.) |
|
|
VerticalContentAlignment | (Inherited from Control.) |
|
|
Visibility | (Inherited from UIElement.) |
|
|
Width | (Inherited from FrameworkElement.) |
| Name | Description | |
|---|---|---|
|
AddHandler | (Inherited from UIElement.) |
|
|
ApplyTemplate | (Inherited from Control.) |
|
|
Arrange | (Inherited from UIElement.) |
|
ArrangeOverride | (Inherited from FrameworkElement.) |
|
|
CancelLoad | Cancels the current data loading operation performed by this DomainDataSource, if any. |
|
|
CancelSubmit | Cancels the current submit operation performed by this DomainDataSource, if any. |
|
|
CaptureMouse | (Inherited from UIElement.) |
|
|
CheckAccess | (Inherited from DependencyObject.) |
|
|
Clear | Clears all data from the DomainDataSource and the underlying EntitySet on the DomainContext. |
|
|
ClearValue | (Inherited from DependencyObject.) |
|
|
DeferLoad | Used to group multiple data loading operations into a single load operation. |
|
|
Equals | (Inherited from Object.) |
|
|
Finalize | (Inherited from Object.) |
|
|
FindName | (Inherited from FrameworkElement.) |
|
|
Focus | (Inherited from Control.) |
|
|
GetAnimationBaseValue | (Inherited from DependencyObject.) |
|
|
GetBindingExpression | (Inherited from FrameworkElement.) |
|
|
GetHashCode | (Inherited from Object.) |
|
|
GetTemplateChild | (Inherited from Control.) |
|
|
GetType | (Inherited from Object.) |
|
|
GetValue | (Inherited from DependencyObject.) |
|
|
InvalidateArrange | (Inherited from UIElement.) |
|
|
InvalidateMeasure | (Inherited from UIElement.) |
|
|
Load | Starts a synchronous data loading operation. |
|
|
Measure | (Inherited from UIElement.) |
|
|
MeasureOverride | (Inherited from FrameworkElement.) |
|
|
MemberwiseClone | (Inherited from Object.) |
|
|
OnApplyTemplate | Builds the visual tree for the DomainDataSource when a new template is applied. (Overrides FrameworkElement.OnApplyTemplate().) |
|
|
OnCreateAutomationPeer | (Inherited from UIElement.) |
|
|
OnDoubleTap | (Inherited from Control.) |
|
|
OnDragEnter | (Inherited from Control.) |
|
|
OnDragLeave | (Inherited from Control.) |
|
|
OnDragOver | (Inherited from Control.) |
|
|
OnDrop | (Inherited from Control.) |
|
|
OnGotFocus | (Inherited from Control.) |
|
|
OnHold | (Inherited from Control.) |
|
|
OnKeyDown | (Inherited from Control.) |
|
|
OnKeyUp | (Inherited from Control.) |
|
|
OnLostFocus | (Inherited from Control.) |
|
|
OnLostMouseCapture | (Inherited from Control.) |
|
|
OnManipulationCompleted | (Inherited from Control.) |
|
|
OnManipulationDelta | (Inherited from Control.) |
|
|
OnManipulationStarted | (Inherited from Control.) |
|
|
OnMouseEnter | (Inherited from Control.) |
|
|
OnMouseLeave | (Inherited from Control.) |
|
|
OnMouseLeftButtonDown | (Inherited from Control.) |
|
|
OnMouseLeftButtonUp | (Inherited from Control.) |
|
|
OnMouseMove | (Inherited from Control.) |
|
|
OnMouseRightButtonDown | (Inherited from Control.) |
|
|
OnMouseRightButtonUp | (Inherited from Control.) |
|
|
OnMouseWheel | (Inherited from Control.) |
|
|
OnTap | (Inherited from Control.) |
|
|
OnTextInput | (Inherited from Control.) |
|
|
OnTextInputStart | (Inherited from Control.) |
|
|
OnTextInputUpdate | (Inherited from Control.) |
|
|
ReadLocalValue | (Inherited from DependencyObject.) |
|
|
RejectChanges | Cancels the data changes that were performed by the underlying DomainContext. |
|
|
ReleaseMouseCapture | (Inherited from UIElement.) |
|
|
RemoveHandler | (Inherited from UIElement.) |
|
|
SetBinding | (Inherited from FrameworkElement.) |
|
|
SetValue | (Inherited from DependencyObject.) |
|
|
SubmitChanges | Submits the changes for every Entity in the DomainContext. |
|
|
ToString | (Inherited from Object.) |
|
|
TransformToVisual | (Inherited from UIElement.) |
|
|
UpdateLayout | (Inherited from UIElement.) |
| Name | Description | |
|---|---|---|
|
BindingValidationError | (Inherited from FrameworkElement.) |
|
|
DoubleTap | (Inherited from UIElement.) |
|
|
GotFocus | (Inherited from UIElement.) |
|
|
Hold | (Inherited from UIElement.) |
|
|
IsEnabledChanged | (Inherited from Control.) |
|
|
KeyDown | (Inherited from UIElement.) |
|
|
KeyUp | (Inherited from UIElement.) |
|
|
LayoutUpdated | (Inherited from FrameworkElement.) |
|
|
Loaded | (Inherited from FrameworkElement.) |
|
|
LoadedData | Occurs when a data loading operation is completed. |
|
|
LoadingData | Occurs when a data loading operation is started. |
|
|
LostFocus | (Inherited from UIElement.) |
|
|
LostMouseCapture | (Inherited from UIElement.) |
|
|
ManipulationCompleted | (Inherited from UIElement.) |
|
|
ManipulationDelta | (Inherited from UIElement.) |
|
|
ManipulationStarted | (Inherited from UIElement.) |
|
|
MouseEnter | (Inherited from UIElement.) |
|
|
MouseLeave | (Inherited from UIElement.) |
|
|
MouseLeftButtonDown | (Inherited from UIElement.) |
|
|
MouseLeftButtonUp | (Inherited from UIElement.) |
|
|
MouseMove | (Inherited from UIElement.) |
|
|
MouseWheel | (Inherited from UIElement.) |
|
|
SizeChanged | (Inherited from FrameworkElement.) |
|
|
SubmittedChanges | Occurs whenever a submit operation is completed. |
|
|
SubmittingChanges | Occurs whenever a submit operation is started. |
|
|
Tap | (Inherited from UIElement.) |
|
|
TextInput | (Inherited from UIElement.) |
|
|
TextInputStart | (Inherited from UIElement.) |
|
|
TextInputUpdate | (Inherited from UIElement.) |
|
|
Unloaded | (Inherited from FrameworkElement.) |
| Name | Description | |
|---|---|---|
|
AutoLoadProperty | Identifies the AutoLoad dependency property. |
|
|
CanLoadProperty | Identifies the CancelLoad dependency property. |
|
|
DataProperty | Identifies the Data dependency property. |
|
|
DataViewProperty | Identifies the DataView dependency property. |
|
|
DesignDataProperty | Identifies the DesignData dependency property. |
|
|
DomainContextProperty | Identifies the DomainContext dependency property. |
|
|
FilterOperatorProperty | Identifies the FilterOperator dependency property. |
|
|
HasChangesProperty | Identifies the HasChanges dependency property. |
|
|
IsBusyProperty | Identifies the IsBusy dependency property. |
|
|
IsLoadingDataProperty | Identifies the IsLoadingData dependency property. |
|
|
IsSubmittingChangesProperty | Identifies the IsSubmittingChanges dependency property. |
|
|
LoadDelayProperty | Identifies the LoadDelay dependency property. |
|
|
LoadIntervalProperty | Identifies the LoadInterval dependency property. |
|
|
LoadSizeProperty | Identifies the LoadSize dependency property. |
|
|
PageSizeProperty | Identifies the PageSize dependency property. |
|
|
QueryNameProperty | Identifies the QueryName dependency property. |
|
|
RefreshIntervalProperty | Identifies the RefreshInterval dependency property. |
Use this component to simplify the interaction between the user interface and data from a DomainContext. After specifying a DomainContext and QueryName, the DomainDataSource can load data and expose it through the Data and DataView properties.
For more information, see DomainDataSource.
The following example shows a DomainDataSource that retrieves data from a domain context named ProductDomainContext and displays the data in a DataGrid control. A query method called GetProducts() must exist on the domain service for the example to work. The DomainDataSource includes two filter descriptors that are connected by a logical AND statement. One filter depends on user input and one filter is specified in the declarative syntax.
<Grid x:Name="LayoutRoot" Background="White"> <Grid.RowDefinitions> <RowDefinition Height="25" /> <RowDefinition Height="Auto" /> </Grid.RowDefinitions> <riaControls:DomainDataSource x:Name="source" QueryName="GetProducts" AutoLoad="true"> <riaControls:DomainDataSource.DomainContext> <domain:ProductDomainContext /> </riaControls:DomainDataSource.DomainContext> <riaControls:DomainDataSource.FilterDescriptors> <riaData:FilterDescriptorCollection LogicalOperator="And"> <riaData:FilterDescriptor PropertyPath="Color" Operator="IsEqualTo" Value="Blue" /> <riaData:FilterDescriptor PropertyPath="ListPrice" Operator="IsLessThanOrEqualTo"> <riaControls:ControlParameter ControlName="MaxPrice" PropertyName="SelectedItem.Content" RefreshEventName="SelectionChanged" /> </riaData:FilterDescriptor> </riaData:FilterDescriptorCollection> </riaControls:DomainDataSource.FilterDescriptors> </riaControls:DomainDataSource> <ComboBox x:Name="MaxPrice" Grid.Row="0" Width="60" SelectedIndex="0"> <ComboBoxItem Content="100" /> <ComboBoxItem Content="500" /> <ComboBoxItem Content="1000" /> </ComboBox> <data:DataGrid Grid.Row="1" ItemsSource="{Binding Data, ElementName=source}" /> </Grid>
