概要
本文分步介绍了如何从使用 Visual C# .NET 开发的自动化客户端处理 Microsoft Excel 事件。
事件处理概述
Visual C# .NET 使用委派处理来自组件对象模型 (COM) 服务器的事件。委派是 Microsoft Visual Studio .NET 中的一个新概念。对于 COM 事件，委派是一种特殊对象，它侦听来自 COM 服务器的事件，然后将其转发给 Visual C# 函数。要使用委派，必须创建对象的实例，然后将该对象实例添加到要侦听的事件中。每个事件都有一个委派，该委派专门设计用于将 COM 事件（使用本机数据类型）转换为标准 Microsoft .NET 调用（使用托管数据类型）。
创建 Visual C# .NET 自动化客户端
要使用委派从使用 Visual C# .NET 开发的自动化客户端处理 Excel 事件，请按照下列步骤操作：
| 1. |
启动 Visual Studio .NET 2002 或 Visual Studio .NET 2003。在“文件”菜单上，单击“新建”，然后单击“项目”。在“Visual C# 项目”下，选择“Windows 应用程序”。将项目命名为 XLEventTest，然后单击“确定”。
默认情况下会创建 Form1。 |
| 2. |
添加对“Microsoft Excel 对象库”的引用。为此，请按照下列步骤操作：
| a. |
在“项目”菜单上，单击“添加引用”。 |
| b. |
在“COM”选项卡上，找到“Microsoft Excel 11.0 对象库”，然后单击“选择”。 |
| c. |
在“添加引用”对话框中单击“确定”，接受您的选择。如果系统提示您为选定的库生成包装，请单击“是”。 |
|
| 3. |
在解决方案资源管理器中，双击“Form1.cs”以在“设计”视图中显示该窗体。 |
| 4. |
在“视图”菜单上，单击“工具箱”以显示工具箱，然后向 Form1 中添加一个按钮。将该按钮的“Text”属性更改为启动 Excel。 |
| 5. |
双击“启动 Excel”以显示该窗体的“代码”窗口。将以下代码添加到该按钮的 Click 事件处理程序中：
private void button1_Click(object sender, System.EventArgs e)
{
StartExcelAndSinkEvents();
}
|
| 6. |
在靠近文件顶部、另一个 using 语句下方添加以下代码：
using System.Reflection;
using System.Diagnostics;
using Excel = Microsoft.Office.Interop.Excel;
|
| 7. |
将以下代码添加到 Form1 类中，使其位于步骤 5 中的 Click 事件处理程序的下方：
//Excel Automation variables:
Excel.Application xlApp;
Excel.Workbook xlBook;
Excel.Worksheet xlSheet1, xlSheet2, xlSheet3;
//Excel event delegate variables:
Excel.AppEvents_WorkbookBeforeCloseEventHandler EventDel_BeforeBookClose;
Excel.DocEvents_ChangeEventHandler EventDel_CellsChange;
private void StartExcelAndSinkEvents()
{
//Start Excel, and then create a new workbook.
xlApp = new Excel.Application();
xlBook = xlApp.Workbooks.Add( Missing.Value );
xlBook.Windows.get_Item(1).Caption = "XL Event Test";
xlSheet1 = (Excel.Worksheet)xlBook.Worksheets.get_Item(1);
xlSheet2 = (Excel.Worksheet)xlBook.Worksheets.get_Item(2);
xlSheet3 = (Excel.Worksheet)xlBook.Worksheets.get_Item(3);
xlSheet1.Activate();
//Add an event handler for the WorkbookBeforeClose Event of the
//Application object.
EventDel_BeforeBookClose =
new Excel.AppEvents_WorkbookBeforeCloseEventHandler( BeforeBookClose);
xlApp.WorkbookBeforeClose += EventDel_BeforeBookClose;
//Add an event handler for the Change event of both worksheet objects.
EventDel_CellsChange = new Excel.DocEvents_ChangeEventHandler( CellsChange);
xlSheet1.Change += EventDel_CellsChange;
xlSheet2.Change += EventDel_CellsChange;
xlSheet3.Change += EventDel_CellsChange;
//Make Excel visible and give the user control.
xlApp.Visible = true;
xlApp.UserControl = true;
}
private void CellsChange(Excel.Range Target )
{
//This is called when any cell on a worksheet is changed.
Debug.WriteLine("Delegate: You Changed Cells " +
Target.get_Address( Missing.Value, Missing.Value,
Excel.XlReferenceStyle.xlA1, Missing.Value, Missing.Value ) +
" on " + Target.Worksheet.Name);
}
private void BeforeBookClose(Excel.Workbook Wb, ref bool Cancel )
{
//This is called when you choose to close the workbook in Excel.
//The event handlers are removed, and then the workbook is closed
//without saving the changes.
Wb.Saved = true;
Debug.WriteLine("Delegate: Closing the workbook and removing event handlers.");
xlSheet1.Change -= EventDel_CellsChange;
xlSheet2.Change -= EventDel_CellsChange;
xlSheet3.Change -= EventDel_CellsChange;
xlApp.WorkbookBeforeClose -= EventDel_BeforeBookClose;
}
|
测试代码
| 1. |
按 Ctrl+Alt+O 以显示“输出”窗口。 |
| 2. |
按 F5 生成并运行该程序。 |
| 3. |
在窗体上，单击“启动 Excel”按钮。
程序将启动 Excel，然后创建一个具有三张工作表的工作簿。 |
| 4. |
向任一张工作表的单元格中添加任意数据。
查看 Visual Studio 中的“输出”窗口，以确认调用了事件处理程序。 |
| 5. |
退出 Excel，然后关闭窗体以结束调试会话。 |
疑难解答
编译代码时，可能会收到以下编译器错误消息：
命名空间已经包含了“Excel”的定义
如果没有安装用于 Excel 的主互操作程序集 (PIA)，则会收到此错误消息。要解决此问题，请按照下列步骤操作：
| 1. |
运行 Microsoft Office 安装程序，然后安装 Excel PIA。在 Office 安装程序中，PIA 显示为 Excel 下的一个组件“.NET 可编程性支持”。 |
| 2. |
打开您的项目，删除对 Excel 互操作程序集的引用，然后重复本文“创建 Visual C# .NET 自动化客户端”部分中的步骤 2，以正确地引用 PIA。 |
测试该代码时，您可能会收到以下错误消息：
未处理的“System.InvalidCastException”类型的异常出现在 interop.excel.dll 中。
其他信息:不支持此种接口
