企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
# 如何:通过使用 Visual C# 功能访问 Office 互操作对象(C# 编程指南) Visual C# 2010 引入了可以简化对 Office API 对象的访问的新功能。这些新功能包括命名实参和可选实参、名为 **dynamic** 的新类型,以及在 COM 方法中将实参传递为引用形参(就像它们是值形参)的功能。 在本主题中,你将利用这些新功能来编写创建并显示 Microsoft Office Excel 工作表的代码。然后,你将编写添加包含链接到 Excel 工作表的图标的 Office Word 文档的代码。 若要完成本演练,你的计算机上必须安装 Microsoft Office Excel 2007 和 Microsoft Office Word 2007 或更高版本。 如果你使用的操作系统早于 Windows Vista,请确保安装 .NET Framework 2.0。 | ![](https://box.kancloud.cn/2016-01-31_56adb62c1380a.jpg) 注意 | | :-- | | 以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。 有关详细信息,请参阅[个性化 Visual Studio IDE](https://msdn.microsoft.com/zh-CN/library/mt269425.aspx)。 | ## 创建新的控制台应用程序 1. 启动 Visual Studio。 2. 在**“文件”**菜单上,指向**“新建”**,然后单击**“项目”**。 出现 **新建项目** 对话框。 3. 在“已安装的模板”窗格中,展开“Visual C#”,然后单击“Windows”。 4. 查看“新建项目”对话框的顶部,确保“.NET Framework 4”(或更高版本)选为目标框架。 5. 在**“模板”**窗格中,单击**“控制台应用程序”**。 6. 在“名称”字段中键入项目的名称。 7. 单击“确定”。 新项目将出现在“解决方案资源管理器”中。 ## 添加引用 1. 在“解决方案资源管理器”中,右键单击你的项目名称,然后单击“添加引用”。将显示**“添加引用”**对话框。 2. 在“程序集”页上,在“组件名称”列表中选择“Microsoft.Office.Interop.Word”,然后按住 Ctrl 键并选择“Microsoft.Office.Interop.Excel”。如果未看到程序集,你可能需要确保安装并显示它们(参阅[如何:安装 Office 主互操作程序集](https://msdn.microsoft.com/zh-CN/library/kh3965hw.aspx)) 3. 单击“确定”。 ## 添加必要的 using 指令 1. 在“解决方案资源管理器”中,右键单击“Program.cs”文件,然后单击“查看代码”。 2. 将以下 **using** 指令添加到代码文件的顶部。 ``` using Excel = Microsoft.Office.Interop.Excel; using Word = Microsoft.Office.Interop.Word; ``` ## 创建银行帐户列表 1. 将以下类定义粘贴到“Program.cs”中的 Program 类下。 ``` public class Account { public int ID { get; set; } public double Balance { get; set; } } ``` 2. 将以下代码添加到 Main 方法,以创建包含两个帐户的 bankAccounts 列表。 ``` // Create a list of accounts. var bankAccounts = new List&lt;Account&gt; { new Account { ID = 345678, Balance = 541.27 }, new Account { ID = 1230221, Balance = -127.44 } }; ``` ## 声明将帐户信息导出到 Excel 的方法 1. 将以下方法添加到 Program 类以设置 Excel 工作表。 方法 [Add](http://go.microsoft.com/fwlink/?LinkId=210910) 有一个可选参数,用于指定特定的模板。如果希望使用形参的默认值,你可以借助可选形参(Visual C# 2010 中新增)忽略该形参的实参。由于以下代码中未发送任何参数,**Add** 将使用默认模板并创建新的工作簿。C# 早期版本中的等效语句要求占位符参数:ExcelApp.Workbooks.Add(Type.Missing). ``` static void DisplayInExcel(IEnumerable&lt;Account&gt; accounts) { var excelApp = new Excel.Application(); // Make the object visible. excelApp.Visible = true; // Create a new, empty workbook and add it to the collection returned // by property Workbooks. The new workbook becomes the active workbook. // Add has an optional parameter for specifying a praticular template. // Because no argument is sent in this example, Add creates a new workbook. excelApp.Workbooks.Add(); // This example uses a single workSheet. The explicit type casting is // removed in a later procedure. Excel._Worksheet workSheet = (Excel.Worksheet)excelApp.ActiveSheet; } ``` 2. 在 DisplayInExcel 的末尾添加以下代码。代码将值插入工作表第一行的前两列。 ``` // Establish column headings in cells A1 and B1. workSheet.Cells[1, "A"] = "ID Number"; workSheet.Cells[1, "B"] = "Current Balance"; ``` 3. 在 DisplayInExcel 的末尾添加以下代码。 **foreach** 循环将帐户列表中的信息放入工作表连续行的前两列。 ``` var row = 1; foreach (var acct in accounts) { row++; workSheet.Cells[row, "A"] = acct.ID; workSheet.Cells[row, "B"] = acct.Balance; } ``` 4. 在 DisplayInExcel 的末尾添加以下代码以将列宽调整为适合内容。 ``` workSheet.Columns[1].AutoFit(); workSheet.Columns[2].AutoFit(); ``` 早期版本的 C# 要求显式强制转换这些操作,因为 ExcelApp.Columns[1] 返回 **Object**,**AutoFit** 为 Excel [Range](http://go.microsoft.com/fwlink/?LinkId=210911) 方法。以下各行显示强制转换。 ``` ((Excel.Range)workSheet.Columns[1]).AutoFit(); ((Excel.Range)workSheet.Columns[2]).AutoFit(); ``` 如果程序集由 [/link](https://msdn.microsoft.com/zh-CN/library/dd264728.aspx) 编译器选项引用或者如果 Excel 的“嵌入互操作类型”属性设置为 true,则 Visual C# 2010 及更高版本会自动将返回的 **Object** 转换为 **dynamic**。True 是此属性的默认值。 ## 运行项目 1. 在 Main 的末尾添加以下行。 ``` // Display the list in an Excel spreadsheet. DisplayInExcel(bankAccounts); ``` 2. 按 Ctrl+F5。 出现包含两个帐户数据的 Excel 工作表。 ## 添加 Word 文档 1. 若要说明 Visual C# 2010 以及更高版本在其他哪些方面增强了 Office 编程,可以使用以下代码打开 Word 应用程序并创建链接到 Excel 工作表的图标。 将方法 CreateIconInWordDoc(在此步骤后面提供)粘贴到 Program 类中。 CreateIconInWordDoc 利用命名参数和可选参数来降低对 [Add](http://go.microsoft.com/fwlink/?LinkId=210937) 和 [PasteSpecial](http://go.microsoft.com/fwlink/?LinkId=147099) 的方法调用的复杂度。这些调用合并了其他两项新功能,这两项新功能在简化对具有引用参数的 COM 方法的调用的 Visual C# 2010 中引入。首先,你可以将实参发送到引用形参,就像它们是值形参一样。即,你可以直接发送值,而无需为每个引用参数创建变量。编译器会生成临时变量以保存参数值,并将在你从调用返回时丢弃变量。其次,你可以忽略参数列表中的 **ref** 关键字。 **Add** 方法有四个引用参数,所有引用参数都是可选的。在 Visual C# 2010 或更高版本中,如果希望使用其默认值,可以忽略任何或所有形参的实参。在 Visual C# 2008 以及更早版本中,由于形参是引用形参,因此必须为每个形参提供实参且实参必须是变量。 **PasteSpecial** 方法可插入剪贴板的内容。该方法有七个引用参数,所有引用参数都是可选的。以下代码为其中两个形参指定实参:Link 用于创建指向剪贴板内容源的连接,DisplayAsIcon 用于将链接显示为图标。在 Visual C# 2010 中,你可以对其中两个形参使用命名实参而忽略其他形参。尽管这些是引用形参,你也不必使用 **ref** 关键字,或者创建变量以实参形式发送。你可以直接发送值。在 Visual C# 2008 以及早期版本中,你必须为每个引用形参发送变量实参。 ``` static void CreateIconInWordDoc() { var wordApp = new Word.Application(); wordApp.Visible = true; // The Add method has four reference parameters, all of which are // optional. Visual C# 2010 allows you to omit arguments for them if // the default values are what you want. wordApp.Documents.Add(); // PasteSpecial has seven reference parameters, all of which are // optional. This example uses named arguments to specify values // for two of the parameters. Although these are reference // parameters, you do not need to use the ref keyword, or to create // variables to send in as arguments. You can send the values directly. wordApp.Selection.PasteSpecial( Link: true, DisplayAsIcon: true); } ``` 在 Visual C# 2008 或早期版本的语言中,需要以下更复杂的代码。 ``` static void CreateIconInWordDoc2008() { var wordApp = new Word.Application(); wordApp.Visible = true; // The Add method has four parameters, all of which are optional. // In Visual C# 2008 and earlier versions, an argument has to be sent // for every parameter. Because the parameters are reference // parameters of type object, you have to create an object variable // for the arguments that represents 'no value'. object useDefaultValue = Type.Missing; wordApp.Documents.Add(ref useDefaultValue, ref useDefaultValue, ref useDefaultValue, ref useDefaultValue); // PasteSpecial has seven reference parameters, all of which are // optional. In this example, only two of the parameters require // specified values, but in Visual C# 2008 an argument must be sent // for each parameter. Because the parameters are reference parameters, // you have to contruct variables for the arguments. object link = true; object displayAsIcon = true; wordApp.Selection.PasteSpecial( ref useDefaultValue, ref link, ref useDefaultValue, ref displayAsIcon, ref useDefaultValue, ref useDefaultValue, ref useDefaultValue); } ``` 2. 在 Main 的末尾添加以下语句。 ``` // Create a Word document that contains an icon that links to // the spreadsheet. CreateIconInWordDoc(); ``` 3. 在 DisplayInExcel 的末尾添加以下语句。 **Copy** 方法可将工作表添加到剪贴板。 ``` // Put the spreadsheet contents on the clipboard. The Copy method has one // optional parameter for specifying a destination. Because no argument // is sent, the destination is the Clipboard. workSheet.Range["A1:B3"].Copy(); ``` 4. 按 Ctrl+F5。 将出现包含图标的 Word 文档。双击该图标以将工作表置于前台。 ## 设置嵌入互操作类型属性 1. 当调用运行时不需要主互操作程序集 (PIA) 的 COM 类型时,可能实现其他增强。删除 PIA 的依赖项可实现版本独立性并且更易于部署。有关不使用 PIA 编程的优势的详细信息,请参阅[演练:嵌入托管程序集中的类型(C# 和 Visual Basic)](https://msdn.microsoft.com/zh-CN/library/dd409610.aspx)。 此外,由于可以通过使用类型 **dynamic**(而非 **Object**)表示 COM 方法必需并返回的类型,因此更易于编程。具有类型 **dynamic** 的变量在运行时以前均不会计算,从而消除了显式强制转换的需要。有关详细信息,请参阅[使用类型 dynamic(C# 编程指南)](https://msdn.microsoft.com/zh-CN/library/dd264736.aspx)。 在 Visual C# 2010 中,默认行为是嵌入类型信息,而不是使用 PIA。由于该默认行为,因此不需要显式强制转换,之前的几个示例也得到简化。例如,DisplayInExcel 中 worksheet 的声明会写为 Excel._Worksheet workSheet = excelApp.ActiveSheet 而非 Excel._Worksheet workSheet = (Excel.Worksheet)excelApp.ActiveSheet。在相同方法中对 **AutoFit** 的调用还将要求在不进行默认行为的情况下显式强制转换,因为 ExcelApp.Columns[1] 返回 **Object**,并且 **AutoFit** 为 Excel 方法。以下代码显示强制转换。 ``` ((Excel.Range)workSheet.Columns[1]).AutoFit(); ((Excel.Range)workSheet.Columns[2]).AutoFit(); ``` 2. 若要更改默认行为并使用 PIA 代替嵌入类型信息,请展开“解决方案资源管理器”中的“引用”节点,然后选择“Microsoft.Office.Interop.Excel”或“Microsoft.Office.Interop.Word”。 3. 如果看不到“属性”窗口,请按“F4”。 4. 在属性列表中找到“嵌入互操作类型”,将其值更改为“False”。同样地,你还可以通过在命令提示符下使用 [/reference](https://msdn.microsoft.com/zh-CN/library/yabyz3h4.aspx) 编译器选项代替 [/link](https://msdn.microsoft.com/zh-CN/library/dd264728.aspx) 进行编译。 ## 将其他格式添加到表格 1. 将在 DisplayInExcel 中对 **AutoFit** 的两个调用替换为以下语句。 ``` // Call to AutoFormat in Visual C# 2010. workSheet.Range["A1", "B3"].AutoFormat( Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2); ``` [AutoFormat](http://go.microsoft.com/fwlink/?LinkId=210948) 方法有七个值参数,每个值参数都是可选的。使用命名参数和可选参数,你可以为这些参数中的所有或部分提供参数,也可以不为它们中的任何一个提供。在上一条语句中,仅为其中一个形参 Format 提供实参。由于 Format 是参数列表中的第一个参数,因此无需提供参数名称。但是,如果包含参数名称,语句则可能更易于理解,如以下代码所示。 ``` // Call to AutoFormat in Visual C# 2010. workSheet.Range["A1", "B3"].AutoFormat(Format: Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2); ``` 2. 按 Ctrl+F5 查看结果。其他格式在 [XlRangeAutoFormat](http://go.microsoft.com/fwlink/?LinkId=210967) 枚举中列出。 3. 将步骤 1 中的语句与以下代码比较(以下代码显示 Visual C# 2008 或早期版本中要求的参数)。 ``` // The AutoFormat method has seven optional value parameters. The // following call specifies a value for the first parameter, and uses // the default values for the other six. // Call to AutoFormat in Visual C# 2008\. This code is not part of the // current solution. excelApp.get_Range("A1", "B4").AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormatTable3, Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing); ``` 以下代码显示完整示例。 ``` using System; using System.Collections.Generic; using System.Linq; using Excel = Microsoft.Office.Interop.Excel; using Word = Microsoft.Office.Interop.Word; namespace OfficeProgramminWalkthruComplete { class Walkthrough { static void Main(string[] args) { // Create a list of accounts. var bankAccounts = new List<Account> { new Account { ID = 345678, Balance = 541.27 }, new Account { ID = 1230221, Balance = -127.44 } }; // Display the list in an Excel spreadsheet. DisplayInExcel(bankAccounts); // Create a Word document that contains an icon that links to // the spreadsheet. CreateIconInWordDoc(); } static void DisplayInExcel(IEnumerable<Account> accounts) { var excelApp = new Excel.Application(); // Make the object visible. excelApp.Visible = true; // Create a new, empty workbook and add it to the collection returned // by property Workbooks. The new workbook becomes the active workbook. // Add has an optional parameter for specifying a praticular template. // Because no argument is sent in this example, Add creates a new workbook. excelApp.Workbooks.Add(); // This example uses a single workSheet. Excel._Worksheet workSheet = excelApp.ActiveSheet; // Earlier versions of C# require explicit casting. //Excel._Worksheet workSheet = (Excel.Worksheet)excelApp.ActiveSheet; // Establish column headings in cells A1 and B1. workSheet.Cells[1, "A"] = "ID Number"; workSheet.Cells[1, "B"] = "Current Balance"; var row = 1; foreach (var acct in accounts) { row++; workSheet.Cells[row, "A"] = acct.ID; workSheet.Cells[row, "B"] = acct.Balance; } workSheet.Columns[1].AutoFit(); workSheet.Columns[2].AutoFit(); // Call to AutoFormat in Visual C# 2010\. This statement replaces the // two calls to AutoFit. workSheet.Range["A1", "B3"].AutoFormat( Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2); // Put the spreadsheet contents on the clipboard. The Copy method has one // optional parameter for specifying a destination. Because no argument // is sent, the destination is the Clipboard. workSheet.Range["A1:B3"].Copy(); } static void CreateIconInWordDoc() { var wordApp = new Word.Application(); wordApp.Visible = true; // The Add method has four reference parameters, all of which are // optional. Visual C# 2010 allows you to omit arguments for them if // the default values are what you want. wordApp.Documents.Add(); // PasteSpecial has seven reference parameters, all of which are // optional. This example uses named arguments to specify values // for two of the parameters. Although these are reference // parameters, you do not need to use the ref keyword, or to create // variables to send in as arguments. You can send the values directly. wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true); } } public class Account { public int ID { get; set; } public double Balance { get; set; } } } ``` ## 请参阅 [Type.Missing](https://msdn.microsoft.com/zh-CN/library/system.type.missing.aspx) [dynamic(C# 参考)](https://msdn.microsoft.com/zh-CN/library/dd264741.aspx) [使用类型 dynamic(C# 编程指南)](https://msdn.microsoft.com/zh-CN/library/dd264736.aspx) [命名实参和可选实参(C# 编程指南)](https://msdn.microsoft.com/zh-CN/library/dd264739.aspx) [如何:在 Office 编程中使用命名参数和可选参数(C# 编程指南)](https://msdn.microsoft.com/zh-CN/library/dd264738.aspx)