通过

如何：通过使用 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。

备注

以下说明中的某些 Visual Studio 用户界面元素在你计算机上的名称或显示位置可能有所不同。这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。有关详细信息，请参阅 在 Visual Studio 中自定义开发设置。

创建新的控制台应用程序

  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 主互操作程序集）

  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<Account> {
    new Account { 
                  ID = 345678,
                  Balance = 541.27
                },
    new Account {
                  ID = 1230221,
                  Balance = -127.44
                }
};

声明将帐户信息导出到 Excel 的方法

  1. 将以下方法添加到 Program 类以设置 Excel 工作表。

    方法 Add 有一个可选参数，用于指定特定的模板。 如果希望使用形参的默认值，你可以借助可选形参（Visual C# 2010 中新增）忽略该形参的实参。 由于以下代码中未发送任何参数，Add 将使用默认模板并创建新的工作簿。 C# 早期版本中的等效语句要求占位符参数：ExcelApp.Workbooks.Add(Type.Missing).

    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. 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 方法。 以下各行显示强制转换。

    ((Excel.Range)workSheet.Columns[1]).AutoFit();
((Excel.Range)workSheet.Columns[2]).AutoFit();

    如果程序集由 /link 编译器选项引用或者如果 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 和 PasteSpecial 的方法调用的复杂度。 这些调用合并了其他两项新功能，这两项新功能在简化对具有引用参数的 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）。

    此外，由于可以通过使用类型 dynamic（而非 Object）表示 COM 方法必需并返回的类型，因此更易于编程。 具有类型 dynamic 的变量在运行时以前均不会计算，从而消除了显式强制转换的需要。 有关详细信息，请参阅使用类型 dynamic（C# 编程指南）。

    在 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 编译器选项代替 /link 进行编译。

将其他格式添加到表格

  1. 将在 DisplayInExcel 中对 AutoFit 的两个调用替换为以下语句。

    // Call to AutoFormat in Visual C# 2010.
workSheet.Range["A1", "B3"].AutoFormat(
    Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2);

    AutoFormat 方法有七个值参数，每个值参数都是可选的。 使用命名参数和可选参数，你可以为这些参数中的所有或部分提供参数，也可以不为它们中的任何一个提供。 在上一条语句中，仅为其中一个形参 Format 提供实参。 由于 Format 是参数列表中的第一个参数，因此无需提供参数名称。 但是，如果包含参数名称，语句则可能更易于理解，如以下代码所示。

    // Call to AutoFormat in Visual C# 2010.
workSheet.Range["A1", "B3"].AutoFormat(Format:
    Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2);

  2. 按 Ctrl+F5 查看结果。 其他格式在 XlRangeAutoFormat 枚举中列出。

  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; }
    }
}

请参见

任务

如何：在 Office 编程中使用命名参数和可选参数（C# 编程指南）

参考

dynamic（C# 参考）

Type.Missing

概念

命名实参和可选实参（C# 编程指南）

其他资源

使用类型 dynamic（C# 编程指南）