欢迎大家提出意见,一起讨论!
转载请标明是引用于 http://blog.csdn.net/chenyujing1234
源码: http://www.rayfile.com/zh-cn/files/2c3f0ff5-be79-11e1-8f2f-0015c55db73d/ (采用VS2008或VS2010打开)
编译平台:VS2010 + .Net Framework 3.5
语言: C#
系统使用微软SQL Server或SQL Express进行后台数据存储,并且使用Entity Framework来创建实体模型。整个系统由以下4个数据表组成。
(1) Category报表: 保存任务分类信息
(2) Resource表: 保存任务资源信息
(3) Task表: 保存任务详细信息
(4) TaskResource表:保存与任务相关联的资源列表。
在VS中直接创建数据库,步骤如下:
(1) 选择“添加”|“新建项”,选择“基于服务的数据库”。如下图:
点击添加,此时数据库被加到Database文件夹中。VS会弹出数据源配置向导,允许用户先行设计数据库模型,再根据模型产生数据库表。
在这里单击“取消”按钮,示例将使用根据数据库表来生成数据实体模型,因此先使用表设计工具创建表。
(2) 在解决方案资源管理器上双击TaskManager.mdf 文件,VS将弹出服务器资源管理器,并展开数据连接,右击表节点。
在弹出的菜单中选择“添加新表”选项,VS将弹出表设计窗口。如下:
在列名字段中,输入表字段名称,在数据类型下选择类型。
(3) 在创建了表后,可以利用数据库关系图创建表之间的主外键关系。
在服务器资源管理器中,展开数据连接,找到数据库关系系图节点,右击鼠标,选择“添加新关系图”选项。
在图形化的表视图上,右击要设置主键的字段,从弹出的菜单中选择“设置主键”选项,可以拖动表到要建立关系的目标表。如下:
服务器资源管理器还提供了视图、存储过程等节点,允许用户直接在VS中创建存储过程,不需要在开发机上安装SQLServer 版,增加开发效率。
Microsoft Entity Framework是微软基于ADO.NET技术所发展出来的对象关系映射(O/R Mapping)解决方案,早期称为ObjectSpace.
在过去,程序员总是与数据库不可分割,不可避免要使用数据库相关的SQL语句。ORM对象关系映射技术因此而生,NHibernate是.NET平台下
用于实现ORM的热门工具,微软公司不甘落后,推出了ADO.NET Entity Framework框架。
Entity Framework利用了抽象化数据结构的方式,将每个数据库对象都转成应用程序对象(entity),而数据字段都转换为属性(property),
关系则转换为结合属性(association),让数据库的E/R模型完全转成对象模型,因此能让程序员用最熟悉的编程语言来调用访问。
在抽象化的结构之下,则是高度集成与对应结构的概念层、对应层和储存层,以及支持Entity Framework的数据提供者(provider),让数据访问的工作得以顺利与
完整进行。
(1) 为了将TaskManager数据库中的表转换为实例对象模型,在解决方案资源管理器中右击Database文件夹,在弹出的菜单中选择“添加”|“新建项”命令,
选择ADO.NET实体数据模型,点添加后进入到实体数据模型向导窗口。
(2) 在该窗口中选择从数据库生成模型,单击下一步按钮,将进入数据连接选择窗口。选择当前创建的数据库连接。
(3) 在指定了连接后,进入选择数据库对象窗口。如下:
这样之后我们就得到了数据库对应的实例代码文件XXXX.cs,它的开头有下面的说明
//------------------------------------------------------------------------------ // <auto-generated> // 此代码由工具生成。 // 运行时版本:4.0.30319.1 // // 对此文件的更改可能会导致不正确的行为,并且如果 // 重新生成代码,这些更改将会丢失。 // </auto-generated> //------------------------------------------------------------------------------
(4) 在选择完成后,VS进入edmx实体数据模型设计窗口。在该窗口中,为每一个表创建一个对象,将每个字段添加为属性,并在数据库间
指定的表间关系创建对象关系。如下:
(5) 如果在开发中数据库结构发生变更,可以将模型与数据库间保持同步。
在设计器上右击,选择“从数据库更新模型”选项,VS将弹出选择实体模型窗口,选择要更新的实体模型后单击“完成”。
在ToolStrip的项集合编辑器中,将每个按钮的DisplayStyle 指定为Image,如下:
主窗口在启动后,会打开任务面板窗口中,为了重用主窗口的打开窗口代码,创建一个名为OpenChildForm()方法。
主窗口的Shown事件在主窗口已经加载,在显示时发生,在该事件中通过调用OpenChildForm()方法来实现任务面板的显示。
在private void InitializeComponent()中先指定窗体是首次显示后调用的函数:
this.Shown += new System.EventHandler(this.MainForm_Shown);
//主窗口显示Shown时的事件处理代码 private void MainForm_Shown(object sender, EventArgs e) { OpenTaskForm();//使用OpenTaskForm方法打开任务窗口 }
/// <summary> /// o打开任务窗口辅助方法 /// </summary> private void OpenTaskForm() { //判断当前程序中窗口是否己被关闭 if (_taskForm == null || _taskForm.IsDisposed) { //实例化新窗口 _taskForm = new TaskForm(); } //调用通用的OpenChildForm方法打开子窗口 OpenChildForm(_taskForm); }
/// <summary> /// 打开子窗口的通用方法代码 /// </summary> /// <param name="childForm">子窗口Form实例</param> private void OpenChildForm(Form childForm) { childForm.MdiParent = this;//设置MDI父对象 //指定窗口的样式为最大化 childForm.WindowState = FormWindowState.Maximized; childForm.Show();//显示子窗口 }
Shown事件处理代码中调用了OpenTaskForm() 方法,该方法判断_tastForm实例是否已释放。
主窗口为所有的子窗口都维护一个类级别的变量,如果用户重复打开一个已经存在的窗口,将不会重复多次创建。
左侧一个DataGridView控件组成;
右侧是一个自定义的用户控件,用来实现任务详细信息的显示;
底部是一排ComboBox控件允许用户进行选择过滤。
在任务窗口显示时,Shown事件触发,在事件处理代码中完成了数据从数据库的加载工作。
Shown事件代码调用了BindDropDowns()方法向DropDownList控件中填入数据,使用LaadTastList()方法向
DataGridView和TaskViwer控件中填入要显示的任务数据。
private void TaskForm_Shown(object sender, EventArgs e) { BindDropDowns();//绑定到DropDownList控件 LoadTaskList(); }
/// <summary> /// 向提供选择参数的下拉列表框填入数据 /// </summary> private void BindDropDowns() { //填充优先级下拉列表框 Utility.BindTaskPriorityCombo(cmbPriority, true); //填充任务状态下拉列表框 Utility.BindTaskStatusCombo(cmbStatus, true); //填充颜色分类下拉列表框 Utility.BindTaskColorCategoryCombo(cmbColorCategory, true); //填充任务标志下拉列表框 Utility.BindTaskFlagCombo(cmbFlag, true); //从数据表中绑定任务分类到下拉列表框 BindCategoryDropDown(); }
所有Utility类中的BindXXX方法都是用于将定义在公共单元中的任务参数枚举值与ComboBox控件绑定,
只有BindCatagoryDropDown实现了从数据库中加载任务分类数据的功能。
/// <summary> /// 绑定优先级枚举值到下拉列表框 /// </summary> public static void BindTaskPriorityCombo (ComboBox priorityCombo, bool addEmpty) { priorityCombo.DrawMode = DrawMode.OwnerDrawVariable;//设置自绘制模式 //DrawItem事件在绘制项时发生,通过关联该事件提供自定义的绘制方式 priorityCombo.DrawItem += new DrawItemEventHandler(priorityCombo_DrawItem); priorityCombo.Items.Clear();//清空项列表 if (addEmpty) { //如果要添加空白,则添加一个空的字符串 priorityCombo.Items.Add(""); } //使用Enum.GetValues返回枚举值集合 foreach (TaskPriority priority in Enum.GetValues (typeof(TaskPriority))) { //向项中添加枚举值 priorityCombo.Items.Add(priority); } }
由于数据表已经被建模为Entity 实体,因此将使用实体类来直接绑定到ComboBox控件,如下:
/// <summary> /// 绑定到任务分类下拉列表框 /// </summary> private void BindCategoryDropDown() { //实例化EDM模型 TaskManagerEntities taskMgrEntity = new TaskManagerEntities(); //使用ToList方法将ObjectQuery<Category>转换为泛型列表 List<Category> categoryList = taskMgrEntity.Category.ToList(); //为了在ComboBox中插入一个空白列,实例化一个新的Category Category newCategory = new Category(); //将该Category插入到列表第1行 categoryList.Insert(0, newCategory); //指定ComboBox的绑定到的显示成员与值成员 cmbCategory.DisplayMember = "Name"; cmbCategory.ValueMember = "CategoryID"; //指定其DataSource为返回的List<Category>泛型 cmbCategory.DataSource = categoryList; }
Entity Framework中的每个实例表现为System.Data.Objects.ObjectQuery<T>泛型数据,用来表示一个可以返回
特定类型的集合或多个对象的查询。
在使用ObjectQuery执行查询前,必须要实例化ObectContext,这个对象提供了连接和元数据信息,
一个对象查询在以下情形下被执行:
(1)使用循环遍历语句,比如foreach枚举集合。
(2)将该值赋给List<T>泛型集合。
(3)显示调用Execute()方法执行查询。
在BindCategoryDropDown()方法中,
首先实例化了TaskManagerEntities对象。该对象由VS自动生成,派生自global::System.Data.Objects.ObjectContext类。
然后调用ToList()方法将Category表转换为泛型列表,此时查询被执行,数据被取出。
为了在ComboBox 中的第一行显示一个空白行,实例化一个新的Category类,插入到列表的第一行。
LoadTaskList()方法用于将数据绑定到DataGridView 控件,同时根据DataGridView 控件首行数据填充TaskViewer控件显示详细的任务信息。
LoadTaskList() 代码如下:
/// <summary> /// 加载任务列表 /// </summary> public void LoadTaskList() { //实例化ObjectContext的派生类 TaskManagerEntities taskMgrEntity = new TaskManagerEntities(); string whereClause = GetWhereClause();//获取查询参数 //取消自动生成列 gvTasks.AutoGenerateColumns = false; //如果查询条件为空,表示查询所有值 if (string.IsNullOrEmpty(whereClause)) { //查询Task表,并在导航属性中包含Category表 gvTasks.DataSource = taskMgrEntity.Task.Include("Category"); } else { //查询Task表,并在导航属性中包含Category和Resource表 gvTasks.DataSource = taskMgrEntity.Task.Include("Category"). Include("Resource").Where(whereClause); } ///格式化网格行 FormatGridRow(); //如果当前行大于0 if (gvTasks.Rows.Count > 0) { //选中DataGridView的第1行 gvTasks.Rows[0].Selected = true; LoadSelectedTaskDetail();//填充TaskViewer控件 } }
LoadTaskList() 方法将要从数据库中同时拿到多个表的数据,主要数据表Task ,以及与主数据表关联的Category和Resource表。在代码中,首先实例化
TaskManagerEntities这个ObjectContext对象,然后使用GetWhereClause构造LING的where查询语句。
为了让界面显示效果美观,将AutoGenerateColumns属性设置为false手动在项集合编辑器中设置列有显示外观。
如果没有过滤条件,那么将取出所有的Task数据,通过使用ObejctQuery的Include拿出任务关联的Category表中的数据。
如果用户选择了要过滤的参数,比如任务类别或者是通过资源来过滤,那么Task将会包含Category与Resource表,并使用where进行查询。
用户将gvTasks.DataSource属性设置为查询的结果后,DataGridView将显示任务列表数据。
这是由于在GridView的设计中为各列绑定了数据:
任务面板使用FormatGridRow()方法时一步地格式化了DataGridView中的行,如果当前加载的数据行大于0,
那么代码将选中第一行。最后调用LoadSelectedTaskDetail填充TaskViewer控件,用来显示任务详细信息。
GetWhereClause()方法拼合用户下拉列表框中选择的条件下,将这些组合为LING的where语句。代码如下:
/// <summary> /// 根据控件的选择生成where语句 /// </summary> private string GetWhereClause() { string whereClause = ""; //如果选择了优先级选项 if (cmbPriority.SelectedIndex > 0) { //使用ConcatWhereClause连接操作符(AND/OR)与新语句 whereClause = ConcatWhereClause(whereClause, "it.Priority = '" + cmbPriority.Text + "'", string.Empty); } //如果用户选择了要过滤的状态 if (cmbStatus.SelectedIndex > 0) { //查询Status,并连接AND运行符 whereClause = ConcatWhereClause(whereClause, "it.Status = '" + cmbStatus.Text + "'", "AND"); } //如果用户选择了任务分类 if (cmbCategory.SelectedIndex > 0) { //使用Task.Category.CategoryID来过滤任务 whereClause = ConcatWhereClause(whereClause, "it.Category.CategoryID = " + cmbCategory.SelectedValue.ToString(), "AND"); } //如果用户选择了颜色分类下拉列表框 if (cmbColorCategory.SelectedIndex > 0) { //查询ColorCategory属性的值 whereClause = ConcatWhereClause(whereClause, "it.ColorCategory = '" + cmbColorCategory.Text + "'", "AND"); } //如果用户选择了标志下拉列表框 if (cmbFlag.SelectedIndex > 0) { //查询Flag whereClause = ConcatWhereClause(whereClause, "it.Flag = '" + cmbFlag.Text + "'", "AND"); } //返回where语句 return whereClause; }
得到的串比如如下:
在Entity Framework中,指定it表示查询源自身,即Task数据源。在GetWhereClause()方法中,总是判断
ComboBox控件中的SelectedIndex属性是否选择了非0值。然后调用ConcatWhereClause() 方法,该方法接收3个参数:
要合并的where语句,然后是条件、值,最后一个参数表示如查是多条件的话,使用哪一种条件运算符,比如AND 或 OR语句。
FormatGridRow来来格式化DataGridView的行样式。这个方法的存在是为了让不同状态的Task可以具有不一样的显示效果,以便用户可以一眼分辨任务的状态。
/// <summary> /// 格式化网格行 /// </summary> private void FormatGridRow() { //循环遍历DataGridView的行集合 foreach (DataGridViewRow gridRow in gvTasks.Rows) { //通过DataGridViewRow绑定的DataBoundItem对象得到Task Task task = gridRow.DataBoundItem as Task; //获取Task状态字符串 String stringValue = task.Status; if (!string.IsNullOrEmpty(stringValue)) { //将字符串类型的状态转换为枚举值 TaskStatus status = (TaskStatus)Enum.Parse (typeof(TaskStatus), stringValue); //如果当前任务的状态标记为己完成 if (status == TaskStatus.Completed) { //设置DataGridViewRow行的默认样式 gridRow.DefaultCellStyle.Font = new Font(gvTasks.RowsDefaultCellStyle.Font, FontStyle.Strikeout); //指定行的前景色为亮灰色 gridRow.DefaultCellStyle.ForeColor = Color.LightGray; } else { //指定其他样式 } } } }
效果如下图:
DataGridView控件的每一行是一个DataGridViewRow对象,当将DataGridView的DataSource设置为一个对象集合时,
DataGridViewRow的DataBoundItem就是这个集合中的单一的对象。比如将DataGridView绑定到DataSet的某个DataTable数据表上的话,
DataBoundItem就是DataRow对象实例。
LoadSelectedTaskDetail()方法将使用Task对象中的属性来填充在TaskViewer用户控件中的控件,
TaskViewer控件接收一个Task对象来填充自身。因此当选中每一行时,LoadSelectedTaskDetail()方法将从DataGridViewRow的DataBoundItem
中找Task对象,传递给在用户控件中定义的SetTaskDetail定义控件的呈现。代码如下:
/// <summary> /// 根据当前选择的行加载任务详细信息面板 /// </summary> private void LoadSelectedTaskDetail() { //用户必须选中一行才能够显示任务详细 if (gvTasks.SelectedRows != null && gvTasks.SelectedRows.Count > 0) { //从DataBoundItem中获取Task对象实例 Task task = gvTasks.SelectedRows[0].DataBoundItem as Task; //调用SetTaskDetail方法显示任务详细信息 taskViewer1.SetTaskDetail(task); } }
代码中首先判断DataGridView的SelectedRows是否不为null,即是否选中了值,并且DataGridView控件的SelectedRows集合的总数要大于0。
如果条件成立,将从SelectedRews[0]这个DataGridViewRow对象中获取DataBoundItem对象,强制转换为Task类型,
调用TaskViewer 控件的SetTaskDetail方法传入该Task进行显示。
在DataGridView控件中定义了几个DataGridViewImageColume类型的列,比如第一行的任务优先级列、指定颜色分类的ColorCatagory的表以及指定标志的
Flag属性列。
在运行时将使用Task相应的属性来设置DataGridViewImageColumn中要显示的图像。
DataGridView控件的集合编辑器如下图:
为了能在图像列中显示定制的图像,DataGridView的CellFormating事件在需要对单元格进行格式化时产生,通过响应该事件,
可以定制DataGridView单元格的外观。其事件如下:
//定制单元格的显示格式,使单元格能显示出图像 private void gvTasks_CellFormatting (object sender, DataGridViewCellFormattingEventArgs e) { //得到当前要进行格式化设置的列 DataGridViewColumn column = gvTasks.Columns[e.ColumnIndex]; //如果列表为Priority if (column.Name.Equals("Priority")) { //调用该方法为任务优先级列设置图像 FormatPriorityCell(e); } else if (column.Name.Equals("ColorCategory")) { //调用该方法为颜色分类列设置图像 FormatColorCell(e); } else if (column.Name.Equals("TaskFlags")) { //调用该方法用来设置任务标志图像 FormatFlagCell(e); } }
CellFormatting事件的DataGridViewCellFormattingEventArgs类型的参数e包含了要格式化的单元格的一些信息。
比如当前单元格的行或列的索引值,分别是ColumnIndex和RowIndex属性。
CellStyle用来设置当前单元格的样式。如果单元格成功格式化,可以设置FormattingApplied布尔属性。
在代码中,通过e.ColumnIndex的列索引返回DataGridViewColumn对象。通过比较列名称字符串,对于Priority、ColorCateGory和
TaskFlags这3个列,调用Formatxxx()方法进行图像的设置。这3列的值其实是枚举类型,因此这几个方法主要根据在列值转换后的
枚举类型的值,然后从资源中获取图像列要显示的图像。以FormatPriorityCell()方法为例:
/// <summary> /// 格式化优先级单元格 /// </summary> private void FormatPriorityCell(DataGridViewCellFormattingEventArgs e) { // 确保返回值为一个字符串类型 String stringValue = e.Value as string; if (stringValue == null) return;//如果值为空则返回 // 得到当前要设置图像的单元格 DataGridViewCell cell = gvTasks[e.ColumnIndex, e.RowIndex]; //设置单元格的提示信息为字符值 cell.ToolTipText = stringValue; //使用图像替换掉单元格字符串值 switch (stringValue.ToLower()) { case "high"://从资源中取出最高优先级的Bitmap对象 e.Value = Properties.Resources.High_Priority; break; case "low"://从资源中取出最高低先级的Bitmap对象 e.Value = Properties.Resources.Low_Priority; break; case "medium"://从资源中取出中等优先级的Bitmap对象 e.Value = Properties.Resources.Medium_Priority; break; default://默认情况下,显示一个空白的图像 e.Value = Properties.Resources.Empty; break; } }
代码从DataGridViewCellFormattingEventArgs类型参数e中获取单元格当前的值,并转换为字符串形式以便进行判断。
然后将单元格的值设置为DataGridViewCell的ToolTipText 属性,在鼠标停在单元格上时,能在提示信息中显示单元格的值。
如果用户单击DataGridView控件上的单元格时,会触发CellClick事件,在救命通过判断用户是否单击了编辑列来显示一个添加任务窗口。
CellClick事件处理如下:
private void gvTasks_CellClick(object sender, DataGridViewCellEventArgs e) { if (e.RowIndex >= 0 && e.ColumnIndex >= 0)//如果行列都在数据范围内 { //得到当前单击的列 DataGridViewColumn column = gvTasks.Columns[e.ColumnIndex]; if (column.Name == "EditTask")//判断列名是否为EditTask { //从DataBoundItem中获取Task对象 Task task = gvTasks.Rows[e.RowIndex].DataBoundItem as Task; if (task != null) { //调用ShowAddTaskForm方法传入任务ID显示添加或编辑任务窗口 ShowAddTaskForm(task.TaskID); } } } }
CellClick的DataGridViewCellEventArgs类型的参数包含当前单击的行列索引,
通过使用用列索引来获取当前单击的列,判断列的名称是否是要进行处理的列;
然后使用RowIndex得到当前单击的行,通过DataGridViewRow的DataBoundItem属性得到绑定的Task对象实例;
最后调用ShowAddTaskForm()方法传入一个TaskID以便窗口显示当前单击的Task对象实例供用户编辑。
当用户在任务窗口中单击编辑按钮会进入AddTaskForm窗口,或者用户从工具栏中单击“添加新任务”按钮,也会进入到AddTaskForm窗口。
任务编辑窗口提供了一系列的编辑控件;
允许用户更新任务的设置,并通过使用Entity Framework中的实体类与数据库交互,将更改或添加结束保存到数据库。
在设计视图中,使用了一系列的文本框和ComboBox控件允许用户输入或选择,
AddTaskForm窗口的构造函数接收到一个TaskID参数。如果传入的TaskID的值是0, 表示用户是要新建一个任务,
否则将根据传入的参数查找Task对象实例来初始化窗口。窗口构造函数如下:
/// <summary> /// 重载构造函数,接收一个任务ID号 /// </summary> public AddTaskForm(int taskID) { //初始化组件面板 InitializeComponent(); //得到传入的任务ID _taskID = taskID; //如果任务ID为0,表示为新增操作,不允许进行删除 btnDelete.Visible = (taskID > 0); //初始化窗口上面的ComboBox控件,填充内容 InitForm(); //如果任务编号大于0 if (taskID > 0) { //调用LoadTask方法从Task中获取用户界面数据 LoadTask(); } else { } }
代码中,根据传入的TaskID值判断是否是0, 不管是新增还是编辑,总是会使用InitForm()方法来初始化窗口,为窗口的ComboBox控件和CheckListBox控件填充内容。
/// <summary> /// method to initialize form /// </summary> private void InitForm() { BindCategory(); BindResource(); Utility.BindTaskDurationTypeCombo(cmbDurationType, true); Utility.BindTaskPriorityCombo(cmbPriority, true); Utility.BindTaskStatusCombo(cmbStatus, true); Utility.BindTaskColorCategoryCombo(cmbColorCategory, true); Utility.BindTaskFlagCombo(cmbTaskFlag, true); }
如果TaskID>0,表示要对一个已经存在的Task编辑。因此调用了LoadTask()方法加载任务。如下:
public void LoadTask() { //使用GetTask方法从数据库中提取指定ID的Task Task task = GetTask(TaskID); if (task != null) { //设置描述信息 txtDescription.PlainText = task.Description; //设置过期日期 if (task.DueDate.HasValue) { dtpDueDate.Checked = true; dtpDueDate.Value = task.DueDate.Value; } else { dtpDueDate.Checked = false; dtpDueDate.Text = string.Empty; } //从Task的属性中设置控件内容 nudDuration.Value = task.Duration; cmbDurationType.Text = task.DurationType; dtpEndDate.Value = task.EndDate; nudPercentComplete.Value = task.PercentComplete; cmbPriority.Text = task.Priority; cmbTaskFlag.Text = task.Flag; cmbColorCategory.Text = task.ColorCategory; //设置任务分类 if (task.Category != null) { cmbCategory.Text = task.Category.Name; } dtpStartDate.Value = task.StartDate; cmbStatus.Text = task.Status; txtTitle.Text = task.Title; if (!task.Resource.IsLoaded) task.Resource.Load(); foreach (Resource resource in task.Resource) { //选中CheckBoxList中己经具有的资源项 CheckGridResource(resource); } } }
可以看出,代码中调用了GetTask()方法根据指定的任务ID获取Task对象,然后根据Task属性更新用户界面控件属性。
对于与Task关联的Resource和Category,通过Task的导航属性进行操作,利用Entity Framework这种特性可以大大简化传统ADO.NET的实现代码。
CheckGridResource()方法将对CheckListBox中匹配的项设置选中状态,该方法在内部调用了CheckListBox 的SetItemCheecked()方法,来设置
指定索引位置处的Checkstate状态。
GetTask方法使用LINQ语句从数据库中查询指定的TaskID的Task.
其实现如下:
/// <summary> /// 根据指定的TaskID返回Task对象 /// </summary> private Task GetTask(int taskID) { //使用LINQ语法查询指定TaskID的Task var matchs = from res in _taskMgrEntity.Task where res.TaskID == taskID select res; //调用IQueryable<T>的First方法返回首个对象 Task task = matchs.First(); //返回Task对象实例 return task; }
LINQ查询的结果返回IQueryable<Task>类型的对象。通过调用IQueryable<T>的First扩展方法,返回首个
匹配的Task对象,以便用户进行编辑。
当用户编辑完成后,可以单击“保存”按钮。在实现保存前,
首先需要对用户在表单中的输入进行验证,使用ValidateForm()方法完成这一过程。如果成功,将调用SaveTask方法保存任务,同时关闭任务窗口。
保存按钮代码如下:
private void btnSave_Click(object sender, EventArgs e) { if (!ValidateForm())//验证表单输入是否完整 { Utility.ShowErrorMessage("请提供有效信息.", "保存任务错误"); return;//返回过程代码 } SaveTask();//调用SaveTask方法将任务保存回数据库 //设置窗口的DialogResult值 this.DialogResult = DialogResult.OK; this.Close();//关闭窗口 }
ValidateForm将验证用户是否输入了任务标题,如果标题内容为空,将使用ErrorProvider控件在文本框右侧显示一个错误图标。
ErrorProvider比使用消息框(MessageBox)显示错误信息的效果好,因为一旦消息框关闭了错误信息也随之消失,用户可能无法纠正所有错误而要多次弹出错误消息框。
而ErrorProvider会记录所有的错误并能够准确定位在错误发生的窗体或控件上,
显示一个红色图标,当鼠标停在该图标上时能够自动弹出ToolTip提示错误内容。
SaveTask()方法将用户在界面中的输入保存到数据库。当然代码需要判断用户是编辑一条记录还是
新增一条记录,如果是新增记录,将创建一个新的Task对象,在保存时,同时也要保存用户在资源
CheckListBox中选择的资源到TaskResource数据表中,SaveTask代码如下:
/// <summary> /// 保存或更新任务 /// </summary> private void SaveTask() { Task task = null;//保存Task的变量 bool isNew = false;//默认的是否新增标志 if (TaskID > 0)//如果是编辑一条Task { //从数据库中获取原始Task task = GetTask(TaskID); //同时获取与资源相关联的Resource集合 if (!task.Resource.IsLoaded) task.Resource.Load(); } if (task == null)//如果新增一条Task { //实例化一个新的Task对象 task = new Database.Task(); isNew = true;//指定新增标志为True } //从用户界面的控件输入设置Task对象的属性 task.Description = txtDescription.PlainText; if (dtpDueDate.Checked)//获取过期日期的值 { task.DueDate = GetDateTime(dtpDueDate.Value); } else { task.DueDate = null; } task.Duration = (int)nudDuration.Value;//期间长度值 task.DurationType = cmbDurationType.Text;//任务期间类型 task.EndDate = GetDateTime(dtpEndDate.Value);//任务结束日期 task.PercentComplete = (int)nudPercentComplete.Value;//完成百分比 task.Priority = cmbPriority.Text;//优先级 task.ColorCategory = cmbColorCategory.Text;//颜色分类 task.Flag = cmbTaskFlag.Text;//标志 Category category = null;//保存Category对象的变量 if (cmbCategory.SelectedIndex > 0) { //查询指定CategoryID的Category对象 category = _taskMgrEntity.Category.Where("it.CategoryID=" + cmbCategory.SelectedValue).First(); } task.Category = category;//为Task的Category属性赋category对象实例 task.StartDate = GetDateTime(dtpStartDate.Value);//设置开始时间 task.Status = cmbStatus.Text;//设置任务状态文本 task.Title = txtTitle.Text;//获取任务标题 //将CheckListBox中的选择添加到Task的Resource集合 SaveResource(task); if (isNew)//对于新增任务,调用AddToTask方法保存 { _taskMgrEntity.AddToTask(task); } _taskMgrEntity.SaveChanges();//将更改保存回数据库 }
在保存任务时,要记得区分是新增的Task还是对已有的Task进行编辑,因此代码中命名用isNew变量来记录新增值。
很明显如果TaskID的值不是0的话,那么记录就编辑任务。
SaveResource()方法将用户在CheckListBox中选择的资源添加到Task.Resource列表中。
private void btnDelete_Click(object sender, EventArgs e) { DialogResult dlgResult = //显示确认删除消息 Utility.ShowConfirmationBox("你确定要删除当前任务?", "确认"); if (dlgResult == DialogResult.Yes)//如果用户确定删除 { Task task = GetTask(TaskID);//获取要删除的Task对象 if (task != null)//如果Task不为null { //使用ObjectContext的DeleteObject从实例中删除Task _taskMgrEntity.DeleteObject(task); _taskMgrEntity.SaveChanges();//向数据库保存更改 //设置DialogReslut this.DialogResult = DialogResult.OK; this.Close();//关闭窗口 } } }