文件背后的代码
    VSTO支持文档背后的代码,要求开发人员使用VSTO项目中生成的具有预连接上下文和预连接事件的类。这些类有时被称为“代码后面”类,因为它们是与特定文档或工作表相关联的代码。在Word中,与文档对应的类后面有一个代码。在Excel中,工作簿中的classone有多个代码,工作簿中的每个工作表或图表工作表都有一个代码。
    您的代码在文档项目后面的VSTO代码中第一次运行时,当Office引发由为您创建的类后面的任何代码处理的Startup事件。 VSTO通过您正在编写代码的类的代码的基类提供上下文。自定义Excel工作表的类后面的VSTO代码源自包含Excel工作表的所有方法,属性和事件的基类。这使您能够在工作表类的启动方法中编写这样的代码。
    MessageBox.Show(String.Format(“{0} is the sheet name”, this.Name));
    通过使用this.Name,您是指从基类继承的Excel Worksheet对象的Name属性。 清单2-6显示了Excel Worksheet的类后面的VSTO代码。 除了类中的代码中的启动和关闭方法之外,还有一个名为InternalStartup的生成方法。 您不应该将任何代码放在这个InternalStartup方法中,因为它是由VSTO自动生成的,修改它可能会破坏Visual Studio对类后面的代码的支持。 相反,您的启动代码应该在启动事件处理程序中。 文档类后面的VSTO代码也使用部分类来隐藏VSTO生成的一些附加代码。
    清单2-6 VSTO Excel工作簿定制
    VSTO:使用C#开发Excel、Word【9】 - 图1
    using System;
    using System.Data;
    using System.Drawing;
    using System.Windows.Forms;
    using Microsoft.VisualStudio.Tools.Applications.Runtime;
    using Excel = Microsoft.Office.Interop.Excel;
    using Office = Microsoft.Office.Core;

    namespace ExcelWorkbook1
    {
    public partial class Sheet1
    {
    private void Sheet1_Startup(object sender, EventArgs e)
    {
    // Initial entry point.
    // This code gets run first when the code behind is created
    // The context is implicit in the Sheet1 class
    MessageBox.Show(“Code behind the document running.”);
    MessageBox.Show(String.Format(“{0} is the sheet name”, this.Name));
    }

    1. private void Sheet1_Shutdown(object sender, EventArgs e)<br /> {<br /> }
    2. #region VSTO Designer generated code
    3. /// <summary><br /> /// Required method for Designer support - do not modify<br /> /// the contents of this method with the code editor.<br /> /// </summary><br /> private void InternalStartup()<br /> {<br /> this.Startup += new System.EventHandler(Sheet1_Startup);<br /> this.Shutdown += new System.EventHandler(Sheet1_Shutdown);<br /> }
    4. #endregion

    }
    }
    VSTO:使用C#开发Excel、Word【9】 - 图2
    Excel中的文档后面的VSTO代码
    在本节中,我们使用VSTO在Excel中为文档创建一些简单的代码。 首先,启动VSTO并选择文件>新建>项目菜单项。 如前所述,导航到Visual C#根下的Office节点。
    我们将使用C#创建一个Excel工作簿项目。 如果您已经有一个要添加VSTO自定义代码的工作簿,则可以在“新建项目”对话框中单击“确定”后出现的对话框中指定其位置。 这一次,我们将从零开始,创建一个新的,空白的工作簿。
    图2-8 选择与您的代码关联的工作簿
    VSTO:使用C#开发Excel、Word【9】 - 图3
    图2-7 使用“新建项目”对话框创建Excel Workbook项目
    VSTO:使用C#开发Excel、Word【9】 - 图4
    创建项目后,会出现设计器视图,如图2-9所示。
    图2-9 VSTO Excel代码的设计视图。
    VSTO:使用C#开发Excel、Word【9】 - 图5
    请注意图2-9中的一些有趣的事情。 首先,Excel作为设计器在Visual Studio 2005中运行,与开发Windows窗体项目时的Windows窗体设计器相同。
    其次,看菜单栏如图2-10所示。 VSTO将Visual Studio菜单(构建,调试等)和Excel菜单项(格式,数据等)合并在一起。 在Visual Studio和Excel(例如工具)中显示的菜单项通过向Visual Studio菜单(如Microsoft Office Excel工具)添加子菜单进行合并,可以选择此菜单项以查看Excel工具菜单。
    图2-10 合并Visual Studio和Excel菜单
    VSTO:使用C#开发Excel、Word【9】 - 图6
    第三,请注意图2-9中的工具箱包含一个新的类别:Excel控件。使用Visual Studio设计文档时,可以使用Excel用户熟悉的Excel菜单项或Visual Studio用户熟悉的工具箱习惯,创建命名范围和列表对象。
    第四,请注意,在这种情况下,“属性”窗口显示所选对象的属性Sheet1。您可以使用“属性”窗口来编辑Excel对象的属性,与Windows窗体项目中编辑控件和窗体的属性相同。
    第五,请注意,解决方案资源管理器已经有四个类。每个底层的Excel工作表和工作簿对象都由一个可以扩展和自定义的.NET类来表示。当您对设计器中的文档进行更改时,后面的代码将自动更新。例如,将列表对象从工具箱拖到Sheet1设计器上,并将其绘制为10行×4列,如图2-11所示。
    图2-11 在设计器中创建ListObject
    VSTO:使用C#开发Excel、Word【9】 - 图7
    从“属性”窗口可以看到,设计者为新的列表对象选择了一个默认名称。我们可以编辑它,但在这个例子中,我们将保留默认名称List1。
    我们来看看这个工作表背后的代码,并对它进行一些简单的更改。右键单击解决方案资源管理器中的Sheet1.cs并选择查看代码。我们将简要说明两个VSTO功能:ActionsPane和列表对象数据绑定。我们将声明一个Windows窗体按钮作为类的成员变量,并将其称为myButton。在启动事件中,我们将通过将其添加到ActionsPane的Controls集合中,在Excel的“文档操作”任务窗格中显示该按钮。这样做会导致Excel显示“文档操作”任务窗格并显示我们的按钮。我们还将处理按钮的Click事件,当点击按钮时,我们将数据将我们的列表对象绑定到随机生成的DataTable。清单2-7显示了这段代码。
    清单2-7 将文档操作任务窗格和数据添加控件的VSTO自定义将ListObject控件绑定到数据表
    VSTO:使用C#开发Excel、Word【9】 - 图8
    using System;
    using System.Data;
    using System.Drawing;
    using System.Windows.Forms;
    using Microsoft.VisualStudio.Tools.Applications.Runtime;
    using Excel = Microsoft.Office.Interop.Excel;
    using Office = Microsoft.Office.Core;

    namespace ExcelWorkbook1
    {
    public partial class Sheet1
    {
    Button myButton = new Button();
    DataTable table;

    1. private void Sheet1_Startup(object sender, EventArgs e)<br /> {<br /> myButton.Text = "Databind!";<br /> myButton.Click += new EventHandler(myButton_Click);<br /> Globals.ThisWorkbook.ActionsPane.Controls.Add(myButton);<br /> }
    2. void myButton_Click(object sender, EventArgs e)<br /> {<br /> List1.DataSource = null;<br /> table = new DataTable();<br /> Random r = new Random();
    3. for (int i = 0; i < 4; i++)<br /> table.Columns.Add("Col " + i.ToString());
    4. for (int i = 0; i < 20; i++)<br /> table.Rows.Add(r.NextDouble(), r.NextDouble(), <br /> r.NextDouble(), r.NextDouble());
    5. List1.DataSource = table;<br /> }
    6. private void Sheet1_Shutdown(object sender, EventArgs e)<br /> {<br /> }
    7. #region VSTO Designer generated code<br /> /// <summary><br /> /// Required method for Designer support - do not modify<br /> /// the contents of this method with the code editor.<br /> /// </summary><br /> private void InternalStartup()<br /> {<br /> this.Startup += new System.EventHandler(Sheet1_Startup);<br /> this.Shutdown += new System.EventHandler(Sheet1_Shutdown);<br /> }
    8. #endregion<br /> }<br />}<br />![](https://cdn.nlark.com/yuque/0/2020/gif/586817/1597633226448-ef2a5d66-1e71-498c-9cf9-90d6aa5f1fd7.gif#align=left&display=inline&height=20&margin=%5Bobject%20Object%5D&originHeight=20&originWidth=20&size=0&status=done&style=none&width=20)<br />构建并运行代码,并确保Excel启动,为工作表引发启动事件,并将该按钮添加到操作窗格。 单击按钮,生成随机DataTable并绑定到列表对象,如图2-12所示。 退出Excel以结束调试会话。<br />图2-12 运行清单2-7并单击我们添加到“文档操作”任务窗格中的按钮的结果<br />![](https://cdn.nlark.com/yuque/0/2020/png/586817/1597633226533-ffb0a1a5-b1b2-4489-8082-a5b038e491d7.png#align=left&display=inline&height=467&margin=%5Bobject%20Object%5D&originHeight=467&originWidth=501&size=0&status=done&style=none&width=501)<br />我们简要说明了VSTO对“文档操作”任务窗格的支持以及VSTO添加到Excel的列表对象的数据绑定能力。 有关VSTO对“文档操作”任务窗格的支持的更多信息,请参见第15章“使用操作窗格”。 有关VSTO对数据绑定的支持的更多信息,请参见第17章“VSTO数据编程”。<br /> <br />**结论**<br />本章介绍了Office解决方案的三种基本模式:一个自动化可执行文件,一个加载项和一个文档后面的代码。 本章还介绍了如何使用Visual Studio 2005和Visual Studio 2005 Tools for Office构建这三种基本模式的解决方案。<br />现在您知道如何在文档解决方案中创建基本的自动化可执行文件,加载项和代码,您将在下一章中使用这些技能,因为重点转向Excel,Word,Outlook和InfoPath的特定功能 可以在你的解决方案中使用<br />本章仅作为文档中的加载项和代码介绍。 第24章介绍Outlook的VSTO加载项。 第23章介绍Word和Excel的COM加载项。 第3章介绍了Excel的自动化加载项。 第13至17章详细介绍了VSTO文档模型背后的代码。