This walkthrough provides step-by-step instructions to handle the create, update, and delete (CUD) operation using UXScheduleView and WCF RIA Services using MVVM pattern. You will also learn to implement simple binding using UXScheduleView without CUD operation. To learn more, see Walkthrough: Bind UXScheduleView to WCF RIA Services using MVVM Pattern.
In this walkthrough, you will perform the following tasks:
- Create ClientUI MVVM Schedule Application (WCF RIA SP1) project using Intersoft ClientUI MVVM Schedule Application (WCF RIA SP1) project template.
- Create the Model Repository class that represents the Categories, Events and Resources data repository.
- Create the ViewModel class that describes the View.
- Bind the properties of UI controls in the View, such as the EventsSource property of the UXScheduleView, to the ViewModel.
Prerequisites
You need the following components to complete this walkthrough:
- Visual Studio 2010 SP1
- WCF RIA SP1
- Silverlight 4 Tools for Visual Studio 2010
- Intersoft ClientUI
Creating a new ClientUI MVVM Schedule Application (WCF RIA SP1) Project
The first step is to create a new ClientUI MVVM Schedule Application (WCF RIA SP1) project using Intersoft ClientUI MVVM Schedule Application (WCF RIA SP1) project template in Visual Studio.
To create the ClientUI MVVM Schedule Application (WCF RIA SP1) project
- Start Visual Studio 2010.
- Create a new ClientUI MVVM Schedule Application (WCF RIA SP1) project using Intersoft ClientUI MVVM Schedule Application (WCF RIA SP1) project template. To learn more, see Walkthrough: Create New Intersoft ClientUI MVVM Schedule Application (WCF RIA SP1) Template.
Creating Model Repository Class
This section shows how to create the SoftwareDevEventsRepository class, SoftwareDevCategoriesRepository class and SoftwareDevResourcesRepository class that represents the required data repositories used in this walkthrough.
To Create the SoftwareDevEventsRepository Class
- Create a new data repository for SoftwareDevEvents using Intersoft MVVM Data Repository (WCF RIA) item template under the ModelServices folder. You can name it SoftwareDevEventsRepository.cs
- Replace the default base class in the DataRepository and remove the Validate method. If you would like to create a repository that supports editing, choose the EditableDataRepository as the base class instead of the DataRepository.
- Replace all the <T> placeholders with the target entity type such as SoftwareDevEvent.
- Replace the type of the EntityContext property to the default domain context type such as ScheduleViewSampleDataDomainContext.
To Create the SoftwareDevCategoriesRepository and SoftwareDevResourcesRepository Class
- Repeat the steps when creating the SoftwareDevEventsRepository class.
- Replace all the <T> placeholders with the target entity type such as SoftwareDevCategory and SoftwareDevResource.
Creating The View
This section steps you through the process of adding a new calendar page to display a collection of software dev data.
- Add new UXPage in View folder and name it CalendarDev.xaml.
- Add UXScheduleView directly under layout root and set the following properties to the control.
Property Value CanUserAddItems True CanUserDeleteItems True CanUserEditItems True CanUserMoveItems True CanUserResizeItems True
C# Copy Code
<Intersoft:UXScheduleView x:Name="SampleControl1" DisplayDate="1/2/2012" NavigationPanePlaceHolderId="CalendarDevContainer" NavigationPaneBackground="{x:Null}" CalendarHeaderBackground="{x:Null}" CanUserAddItems="True" CanUserDeleteItems="True" CanUserEditItems="True" CanUserMoveItems="True" CanUserResizeItems="True"> <Intersoft:UXScheduleDayView /> <Intersoft:UXScheduleWorkWeekView /> <Intersoft:UXScheduleWeekView IsActive="True"/> <Intersoft:UXScheduleMonthView /> </Intersoft:UXScheduleView>
Creating the ViewModel
This section steps you through the process of creating a ViewModel class that contains the properties to describe the View that you created in the previous section. The ViewModel will inherit from the EditableScheduleViewModelBase class which already contains a set of common members that can be bound to UXScheduleView such as Events as well as the properties related to CUD operation.
To create the SoftwareDevCalendarViewModel
- Add a new class to the ViewModels folder in your Silverlight project and name it SoftwareDevCalendarViewModel.
- Open SoftwareDevCalendarViewModel.cs and inherit it from the EditableScheduleViewModelBase class, then replace the placeholders with the target entity type. I.e.: <SoftwareDevEvent>. The EditableScheduleViewModelBase class contains common members that can be bound to the UXScheduleView control.
C# Copy Code
public class SoftwareDevCalendarViewModel : EditableScheduleViewModelBase<SoftwareDevEvent> { }
- Override the CategoriesDataSource, EventsDataSource and ResourcesDataSource properties from the base class.
C# Copy Code
protected override IDataRepository CategoriesDataSource { get { return SoftwareDevCategoriesRepository.Instance; } } protected override IDataRepository EventsDataSource { get { return SoftwareDevEventsRepository.Instance; } } protected override IDataRepository ResourcesDataSource { get { return SoftwareDevResourcesRepository.Instance; } }
- Override the ExecutePrepaerNewItem method to handle the data insertion.
C# Copy Code
protected override void ExecutePrepareNewItem(object parameter) { base.ExecutePrepareNewItem(parameter); UXScheduleViewEventModel evtModel = parameter as UXScheduleViewEventModel; SoftwareDevEvent evt = this.EditableEventsDataSource.Create(); if (evtModel.ResourceID == -1) { if (evtModel.GroupValues.Count > 0) { foreach (string key in evtModel.GroupValues.Keys) { switch (key) { case "DivisionID": int divisionID = int.Parse(evtModel.GroupValues[key].ToString()); SoftwareDevResource first = this.Resources.Cast<SoftwareDevResource>().Where(o => o.DivisionID == divisionID).FirstOrDefault(); if (first != null) { evt.ResourceID = first.ResourceID; first.SoftwareDevEvents.Add(evt); } break; case "Mode": evt.Mode = int.Parse(evtModel.GroupValues[key].ToString()); break; } } } else { evt.ResourceID = 1; } } this.NewItem = evt; this.EditableEventsDataSource.Insert(evt); }
Binding the View to the ViewModel
In the previous sections, you have learned how to create the Model and ViewModel classes, as well as the View that contains the user interface and controls used in this walkthrough. This section shows how to instantiate the ViewModel in the XAML page and bind the UI elements to the properties in the ViewModel such as the data context and UXScheduleView ItemSource property. You will also learn how to bind properties in UXScheduleView control to handle the CUD operation.
To bind the Customers page to the CustomersViewModel class
- Declare the namespace that maps to the CalendarDevViewModel class in the Customers page.
XAML Copy Code
<Intersoft:UXPage... xmlns:ViewModels="clr-namespace:ClientUI_Schedule_Application.ViewModels" </Intersoft:UXPage>
- Instantiate a new instance of the CalendarDevViewModel class in the UXPage resources and name it CalendarDevViewModel.
XAML Copy Code
<Intersoft:UXPage.Resources> <ViewModels:CalendarDevViewModel x:Key="CalendarDevViewModel" /> ... </Intersoft:UXPage.Resources> <Grid x:Name="LayoutRoot" DataContext="{StaticResource CalendarDevViewModel}"> </Grid>
- Then bind the following properties in UXScheduleView control with property in ViewModel.
Property Value EventsSource {Binding Events} CategoriesSource {Binding Categories} ResourcesSource {Binding Resources} NewItem {Binding NewItem, Mode=TwoWay} PrepareNewItemCommand {Binding PrepareNewItemCommand} InsertItemCommand {Binding InsertItemCommand} DeleteItemCommand {Binding DeleteItemCommand} UpdateItemCommand {Binding UpdateItemCommand} RejectItemCommand {Binding RejectItemCommand} ValidateItemCommand {Binding ValidateItemCommand} SaveChangesCommand {Binding SaveChangesCommand} RefreshCommand {Binding RefreshCommand}
XAML Copy Code
<Intersoft:UXScheduleView x:Name="SampleControl1" DisplayDate="1/2/2012" NavigationPanePlaceHolderId="CalendarDevContainer" NavigationPaneBackground="{x:Null}" CalendarHeaderBackground="{x:Null}" CanUserAddItems="True" CanUserDeleteItems="True" CanUserEditItems="True" CanUserMoveItems="True" CanUserResizeItems="True" EventsSource="{Binding Events}" CategoriesSource="{Binding Categories}" ResourcesSource="{Binding Resources}" NewItem="{Binding NewItem, Mode=TwoWay}" PrepareNewItemCommand="{Binding PrepareNewItemCommand}" InsertItemCommand="{Binding InsertItemCommand}" DeleteItemCommand="{Binding DeleteItemCommand}" UpdateItemCommand="{Binding UpdateItemCommand}" RejectItemCommand="{Binding RejectItemCommand}" ValidateItemCommand="{Binding ValidateItemCommand}" SaveChangesCommand="{Binding SaveChangesCommand}" RefreshCommand="{Binding RefreshCommand}"> <Intersoft:UXScheduleDayView /> <Intersoft:UXScheduleWorkWeekView /> <Intersoft:UXScheduleWeekView IsActive="True"/> <Intersoft:UXScheduleMonthView /> </Intersoft:UXScheduleView>
Adding the CalendarDev page to the navigation pane.
- Open the MainPage.xaml.
- Add new navigation pane item below the existing calendar item and specify the NavigateUri to CalendarDev.
XAML Copy Code
<Intersoft:UXNavigationPaneItem Header="Calendar" NavigateUri="/Calendar/All" NavigationState="/Calendar" Icon="Assets/Images/Calendar.png"> <Grid x:Name="ExternalContainer"/> </Intersoft:UXNavigationPaneItem> <Intersoft:UXNavigationPaneItem Header="CalendarDev" NavigateUri="/CalendarDev" NavigationState="/CalendarDev" Icon="Assets/Images/Calendar.png"> <Grid x:Name="CalendarDevContainer"/> </Intersoft:UXNavigationPaneItem>
- Save and run the project.
Conclusion
In this walkthrough, you have learned how to create ClientUI MVVM Schedule Application (WCF RIA SP1) project using project template, and create the classes and page based on the Model, View and ViewModel pattern and used it to handle CUD operation. You also learned how to bind UXScheduleView to a collection of data.
Complete Code Listing
This section lists the complete code used in this walkthrough.
SoftwareDevCategoriesRepository.cs
C# | ![]() |
---|---|
using System.ServiceModel.DomainServices.Client; using ClientUI_Schedule_Application.Web; namespace ClientUI_Schedule_Application.ModelServices { public class SoftwareDevCategoriesRepository : DataRepository<SoftwareDevCategory> { private static IDataRepository _repository; /// <summary> /// Initializes a new instance of <see cref="PublicationCategoriesRepository"/> class. /// </summary> /// <param name="context">A <see cref="DomainContext"/> instance, providing access to all functionality of the data service.</param> public SoftwareDevCategoriesRepository(DomainContext context) : base(context) { } private static bool IsReusable { get { return true; } } private ScheduleViewSampleDataDomainContext EntityContext { get { return ((ScheduleViewSampleDataDomainContext)this.Context); } } /// <summary> /// Returns an instance of <see cref="PublicationCategoriesRepository"/>. /// If the <see cref="IsReusable"/> is true, the property will return an existing cached copy of the instance. /// </summary> public static IDataRepository Instance { get { if (_repository == null || !IsReusable) _repository = new SoftwareDevCategoriesRepository(RepositoryManager.Create()); return _repository; } } /// <summary> /// Gets the <see cref="EntitySet"/> that provides access to a collection of entities as the results of the entity query. /// </summary> public override EntitySet<SoftwareDevCategory> EntitySet { get { return this.EntityContext.SoftwareDevCategories; } } /// <summary> /// Gets the <see cref="EntityQuery"/> that represents the entity's LINQ query. /// </summary> public override EntityQuery<SoftwareDevCategory> EntityQuery { get { return this.EntityContext.GetSoftwareDevCategoriesQuery(); } } } } |
SoftwareDevEventsRepository.cs
C# | ![]() |
---|---|
using System.ServiceModel.DomainServices.Client; using ClientUI_Schedule_Application.Web; namespace ClientUI_Schedule_Application.ModelServices { public class SoftwareDevEventsRepository : EditableDataRepository<SoftwareDevEvent> { private static IDataRepository _repository; /// <summary> /// Initializes a new instance of <see cref="PublicationCategoriesRepository"/> class. /// </summary> /// <param name="context">A <see cref="DomainContext"/> instance, providing access to all functionality of the data service.</param> public SoftwareDevEventsRepository(DomainContext context) : base(context) { } private static bool IsReusable { get { return true; } } private ScheduleViewSampleDataDomainContext EntityContext { get { return ((ScheduleViewSampleDataDomainContext)this.Context); } } /// <summary> /// Returns an instance of <see cref="PublicationCategoriesRepository"/>. /// If the <see cref="IsReusable"/> is true, the property will return an existing cached copy of the instance. /// </summary> public static IDataRepository Instance { get { if (_repository == null || !IsReusable) _repository = new SoftwareDevEventsRepository(RepositoryManager.Create()); return _repository; } } /// <summary> /// Gets the <see cref="EntitySet"/> that provides access to a collection of entities as the results of the entity query. /// </summary> public override EntitySet<SoftwareDevEvent> EntitySet { get { return this.EntityContext.SoftwareDevEvents; } } /// <summary> /// Gets the <see cref="EntityQuery"/> that represents the entity's LINQ query. /// </summary> public override EntityQuery<SoftwareDevEvent> EntityQuery { get { return this.EntityContext.GetSoftwareDevEventsQuery(); } } } } |
SoftwareDevResourcesRepository.cs
C# | ![]() |
---|---|
using System.ServiceModel.DomainServices.Client; using ClientUI_Schedule_Application.Web; namespace ClientUI_Schedule_Application.ModelServices { public class SoftwareDevResourcesRepository : DataRepository<SoftwareDevResource> { private static IDataRepository _repository; /// <summary> /// Initializes a new instance of <see cref="PublicationCategoriesRepository"/> class. /// </summary> /// <param name="context">A <see cref="DomainContext"/> instance, providing access to all functionality of the data service.</param> public SoftwareDevResourcesRepository(DomainContext context) : base(context) { } private static bool IsReusable { get { return true; } } private ScheduleViewSampleDataDomainContext EntityContext { get { return ((ScheduleViewSampleDataDomainContext)this.Context); } } /// <summary> /// Returns an instance of <see cref="PublicationCategoriesRepository"/>. /// If the <see cref="IsReusable"/> is true, the property will return an existing cached copy of the instance. /// </summary> public static IDataRepository Instance { get { if (_repository == null || !IsReusable) _repository = new SoftwareDevResourcesRepository(RepositoryManager.Create()); return _repository; } } /// <summary> /// Gets the <see cref="EntitySet"/> that provides access to a collection of entities as the results of the entity query. /// </summary> public override EntitySet<SoftwareDevResource> EntitySet { get { return this.EntityContext.SoftwareDevResources; } } /// <summary> /// Gets the <see cref="EntityQuery"/> that represents the entity's LINQ query. /// </summary> public override EntityQuery<SoftwareDevResource> EntityQuery { get { return this.EntityContext.GetSoftwareDevResourcesQuery(); } } } } |
SoftwareDevCalendarViewModel.cs
C# | ![]() |
---|---|
using System.Linq; using Intersoft.Client.UI.ScheduleView; using ClientUI_Schedule_Application.ModelServices; using ClientUI_Schedule_Application.Web; namespace ClientUI_Schedule_Application.ViewModels { public class SoftwareDevCalendarViewModel : EditableScheduleViewModelBase<SoftwareDevEvent> { protected override IDataRepository CategoriesDataSource { get { return SoftwareDevCategoriesRepository.Instance; } } protected override IDataRepository EventsDataSource { get { return SoftwareDevEventsRepository.Instance; } } protected override IDataRepository ResourcesDataSource { get { return SoftwareDevResourcesRepository.Instance; } } protected override void ExecutePrepareNewItem(object parameter) { base.ExecutePrepareNewItem(parameter); UXScheduleViewEventModel evtModel = parameter as UXScheduleViewEventModel; SoftwareDevEvent evt = this.EditableEventsDataSource.Create(); if (evtModel.ResourceID == -1) { if (evtModel.GroupValues.Count > 0) { foreach (string key in evtModel.GroupValues.Keys) { switch (key) { case "DivisionID": int divisionID = int.Parse(evtModel.GroupValues[key].ToString()); SoftwareDevResource first = this.Resources.Cast<SoftwareDevResource>().Where(o => o.DivisionID == divisionID).FirstOrDefault(); if (first != null) { evt.ResourceID = first.ResourceID; first.SoftwareDevEvents.Add(evt); } break; case "Mode": evt.Mode = int.Parse(evtModel.GroupValues[key].ToString()); break; } } } else { evt.ResourceID = 1; } } this.NewItem = evt; this.EditableEventsDataSource.Insert(evt); } } } |
CalendarDev.xaml
XAML | ![]() |
---|---|
<Intersoft:UXPage xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d" xmlns:Intersoft="http://intersoft.clientui.com/schemas" xmlns:ViewModels="clr-namespace:ClientUI_Schedule_Application.ViewModels" x:Class="ClientUI_Schedule_Application.Views.CalendarDev" Title="CalendarDev Page" d:DesignWidth="640" d:DesignHeight="480"> <Intersoft:UXPage.Resources> <ViewModels:SoftwareDevCalendarViewModel x:Key="SoftwareDevCalendarViewModel"/> </Intersoft:UXPage.Resources> <Grid x:Name="LayoutRoot" DataContext="{StaticResource SoftwareDevCalendarViewModel}"> <Intersoft:UXScheduleView x:Name="SampleControl1" DisplayDate="1/2/2012" NavigationPanePlaceHolderId="CalendarDevContainer" NavigationPaneBackground="{x:Null}" CalendarHeaderBackground="{x:Null}" CanUserAddItems="True" CanUserDeleteItems="True" CanUserEditItems="True" CanUserMoveItems="True" CanUserResizeItems="True" EventsSource="{Binding Events}" CategoriesSource="{Binding Categories}" ResourcesSource="{Binding Resources}" NewItem="{Binding NewItem, Mode=TwoWay}" PrepareNewItemCommand="{Binding PrepareNewItemCommand}" InsertItemCommand="{Binding InsertItemCommand}" DeleteItemCommand="{Binding DeleteItemCommand}" UpdateItemCommand="{Binding UpdateItemCommand}" RejectItemCommand="{Binding RejectItemCommand}" ValidateItemCommand="{Binding ValidateItemCommand}" SaveChangesCommand="{Binding SaveChangesCommand}" RefreshCommand="{Binding RefreshCommand}"> <Intersoft:UXScheduleDayView /> <Intersoft:UXScheduleWorkWeekView /> <Intersoft:UXScheduleWeekView IsActive="True"/> <Intersoft:UXScheduleMonthView /> </Intersoft:UXScheduleView> </Grid> </Intersoft:UXPage> |
UXScheduleDayView Class
UXScheduleWeekView Class
UXScheduleWorkWeekView Class
UXScheduleMonthView Class
QueryDescriptor Class
Concepts
Editing Data in UXScheduleView
UXScheduleView
UXScheduleDayView
UXScheduleWeekView
UXScheduleMonthView
QueryDescriptor Overview
Data Access Overview
MVVM Pattern Overview
Other Resources
Walkthroughs and How-to Topics
Locating the Samples in Local Installation