将数据绑定到“Word 操作”窗格上的控件
向项目中添加新的数据源
1.创建一个名为“我的 Word 操作窗格”的Word 文档项目。 在向导中,选择“创建新文档”。
2.在“解决方案资源管理器”中选择“我的 Word 操作窗格”项目。
3.在“项目”菜单上,单击“添加新项”。
4.在“添加新项”对话框中选择“操作窗格控件”,将它命名为“ActionsControl”,然后单击“添加”
5.如果“数据源”窗口不可见,请单击“数据”菜单上的“显示数据源”。
6.单击“添加新数据源”以启动“数据源配置向导”。
7.选择到 Northwind 示例 SQL Server 数据库的数据连接,或者使用“新建连接”按钮添加新连接。
8.展开“数据库对象”窗口中的“表”节点。
9.选择“Suppliers”表和“Products”表旁边的复选框。
10.单击“完成”。
将数据绑定 Windows 窗体控件添加到操作窗格控件
1.在“数据源”窗口中展开“Suppliers”表。单击“Company Name”节点上的下拉箭头并选择“ComboBox”。
2.将“CompanyName”从“数据源”窗口拖动到操作窗格控件中。
操作窗格控件中便会创建一个 ComboBox 控件。 同时,会将一个名为 SuppliersBindingSource 的 BindingSource、一个表适配器和一个 DataSet 添加到组件栏的项目中。
3.选择“组件”栏中的 SuppliersBindingNavigator 并按 Delete。
4.在“数据源”窗口中,展开“Suppliers”表的子表“Products”。
5.单击“ProductName”节点上的下拉箭头,然后选择“ListBox”。
6.将“ProductName”拖动到操作窗格控件中。
7.右击 Button,单击快捷菜单上的“属性”并更改以下属性
Name:insert,文本:插入
使用数据加载控件
1.在 ActionsControl 类的 Load 事件处理程序中,添加以下代码。
private void ActionsControl_Load(object sender, EventArgs e)
{
this.suppliersTableAdapter.Fill(this.northwindDataSet.Suppliers);
this.productsTableAdapter.Fill(this.northwindDataSet.Products);
}
2.在 C# 中,必须将事件处理程序附加到 Load 事件。 可以将这些代码放在 ActionsControl 构造函数中 InitializeComponent调用的后面。
this.Load += new EventHandler(ActionsControl_Load);
设置控件的数据绑定属性
-
选择 CompanyNameComboBox 控件。
-
在“属性”窗口中单击“DataSource”属性右侧的按钮,然后选择“SuppliersBindingSource”。
-
单击“DisplayMember”属性右侧的按钮,然后选择“CompanyName”。
-
展开“DataBindings”属性,单击“Text”属性右侧的按钮,然后选择“None”。
-
选择 ProductNameListBox 控件。
-
在“属性”窗口中单击“DataSource”属性右侧的按钮,然后选择“productsBindingSource”。
-
单击“DisplayMember”属性右侧的按钮,然后选择“ProductName”。
-
展开“DataBindings”属性,单击“SelectedValue”属性右侧的按钮,然后选择“None”。
添加方法以将数据插入表中
下一个任务是从绑定控件中读取数据并填充 Word 文档中的表。 首先,创建一个用于设置表格标题格式的过程,然后添加 AddData 方法以创建一个 Word 表并设置其格式。
设置表格标题的格式
在 ActionsControl 类中创建一个方法,用以设置表格标题的格式。
static void SetHeadings(Microsoft.Office.Interop.Word.Cell tblCell, string text)
{
tblCell.Range.Text = text;
tblCell.Range.Font.Bold = 1;
tblCell.Range.ParagraphFormat.Alignment =
Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphCenter;
}
创建表
在 ActionsControl 类中编写一个方法,此方法将在不存在表的情况下创建一个表,并将操作窗格中的数据添加到此表中。
private void AddData(System.Data.DataRow row, string companyName)
{
object missing = System.Type.Missing;
// Create a table if it doesn't already exist.
if (Globals.ThisDocument.Tables.Count == 0)
{
try
{
// Create a table.
Microsoft.Office.Interop.Word.Table tbl = Globals.ThisDocument.Tables.Add
(Globals.ThisDocument.Application.Selection.Range, 1, 4, ref missing, ref missing);
// Insert headings.
SetHeadings(tbl.Cell(1, 1), "Company Name");
SetHeadings(tbl.Cell(1, 2), "Product Name");
SetHeadings(tbl.Cell(1, 3), "Quantity");
SetHeadings(tbl.Cell(1, 4), "Unit Price");
}
catch (Exception ex)
{
MessageBox.Show("Problem creating Products table: " + ex.Message,
"Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
// Add data from data row to the table.
Microsoft.Office.Interop.Word.Selection selection = Globals.ThisDocument.Application.Selection;
if (selection.Tables.Count > 0)
{
Microsoft.Office.Interop.Word.Row newRow = Globals.ThisDocument.Tables[1].Rows.Add(ref missing);
newRow.Range.Font.Bold = 0;
newRow.Range.ParagraphFormat.Alignment =
Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphLeft;
newRow.Cells[4].Range.ParagraphFormat.Alignment =
Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphRight;
newRow.Cells[1].Range.Text = companyName;
newRow.Cells[2].Range.Text = row["ProductName"].ToString();
newRow.Cells[3].Range.Text = row["QuantityPerUnit"].ToString();
newRow.Cells[4].Range.Text = Math.Round(Convert.ToDouble(row["UnitPrice"])).ToString("#,##0.00");
}
else
{
MessageBox.Show("Cursor must be within a table.",
"Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
在 Word 表中插入文本
1.将以下代码添加到“插入”按钮的 Click 事件处理程序中。
private void Insert_Click(object sender, System.EventArgs e)
{
System.Data.DataTable tbl = northwindDataSet.Products;
System.Data.DataRow[] rows;
// Check if a product is selected.
if (this.productNameListBox.SelectedIndex >= 0)
{
System.Data.DataRowView productRow = (System.Data.DataRowView)this.productNameListBox.SelectedItem;
string product = productRow.Row["ProductName"].ToString();
string company = this.companyNameComboBox.Text;
// Return the data row from the selected product.
rows = tbl.Select("[ProductName] = '" + product.Replace("'", "''") + "'");
this.AddData(rows[0], company);
}
else
{
MessageBox.Show("Please select a product.", "Actions Pane", MessageBoxButtons.OK);
}
}
2.在 C# 中,必须为按钮的 Click 事件创建事件处理程序。 可以将此代码放置在 ActionsControl 类的 Load 事件处理程序中。
this.Insert.Click += new EventHandler(Insert_Click);
显示操作窗格
1.在“解决方案资源管理器”中右击“ThisDocument.vb”或“ThisDocument.cs”,再单击快捷菜单上的“查看代码”。
2.在 ThisDocument 类的顶部创建一个新的控件实例,使其看上去与下面的示例类似。
private ActionsControl actions = new ActionsControl();
3.向 ThisDocument 的 Startup 事件处理程序中添加代码,使其看上去与下面的示例类似。
this.ActionsPane.Controls.Add(actions);
测试应用程序
现在可以对文档进行测试,以验证当文档打开时是否出现操作窗格。 测试操作窗格上控件之间的主/从关系,并确保单击“插入”按钮时数据会填充到 Word 表中
-
按 F5 运行项目。
-
确认操作窗格可见。
-
从组合框中选择一个公司,并确认“Products”列表框中的项随之发生变化。
-
选择一个产品,单击操作窗格上的“插入”,并确认产品详细信息会随之添加到 Word 表中。
-
插入来自不同公司的其他产品。