Northwind 智能客户端示例

更新:2007 年 11 月

ms268995.alert_note(zh-cn,VS.90).gif说明:

本示例只能在 Microsoft Office Excel 2007 和 Microsoft Office Word 2007 中运行。

本示例使用 Excel 和 Word 的文档级自定义项实现基于 Microsoft SQL Server 的 Northwind 示例数据库的订单跟踪系统。该示例包含以下功能:

  • Northwind 目录模板。客户使用此 Excel 模板来浏览 Northwind Supply Company 提供的不同产品。该模板通过调用 Northwind Web 服务从 SQL Server Northwind 数据库中检索产品信息。使用此模板,客户可以购买不同产品,查看和更新他们的订单,以及填写送货信息完成订单。工作簿保留关于各次使用的订单信息,使客户可以脱机使用目录。

    ms268995.alert_note(zh-cn,VS.90).gif说明:

    该模板不检索已提交的订单;它只创建和编辑新订单。

  • Northwind Web 服务。客户完成订单后,会单击“签出”,将订单提交给 Northwind Web 服务。Web 服务将订单信息添加到 Northwind 订单汇总工作簿并返回一个订单 ID。

  • Northwind 订单汇总工作簿。此 Excel 工作簿提供通过 Northwind 目录和 Northwind Web 服务提交的所有新订单的合并视图。用户可以跟踪公司的订单历史记录,查看哪些产品被购买、购买者是谁、他们购买的频率以及购买的价格。

  • Northwind 网站。用户可以从 ASPX 页查看提交到 Northwind Web 服务的所有订单的列表。此页从 Northwind 订单汇总工作簿读取数据。用户可以选择一个订单并单击“创建发票”按钮,将该订单的数据写入从 Northwind 发票模板生成的新文档中。他们也可以通过单击“查看发票”查看已经创建的发票。

  • Northwind 发票模板。Northwind Supply Company 的员工使用此 Word 模板为客户创建发票。当员工打开该模板时,如果数据已经被 Northwind 网站添加到数据缓存中,则该数据的发票就创建好了。如果数据缓存中没有数据,将显示一个 Windows 窗体,用户可以选择为哪位客户和哪个订单创建发票。然后 Northwind 发票模板将用来自 Northwind 订单汇总工作簿的数据创建发票。

ms268995.alert_security(zh-cn,VS.90).gif安全说明:

此示例代码的用途在于阐释概念,因此只显示了与该概念相关的代码。示例代码不一定满足特定环境的安全要求,不应原样照搬使用。我们建议您添加安全性代码和错误处理代码,让您的项目更加安全可靠。Microsoft 按“原样”提供此示例代码,不提供任何保证。

有关如何在计算机上安装示例项目的信息,请参见 如何:安装和使用“帮助”中找到的示例文件

Download sample

运行此示例

  1. 在 NorthwindWebService 项目的 App_Code 子文件夹中,打开文件 Service.vb(在 Visual Basic 中)或 Service.cs(在 C# 中)。

  2. 找到标有 TODO: 的注释。

  3. 将 workbookLocation 变量的值更改为指向示例的安装位置。

  4. 在 NorthwindWebSite 项目中,打开文件 Default.aspx.vb(在 Visual Basic 中)或 Default.aspx.cs(在 C# 中)。

  5. 找到标有 TODO: 的两个注释。

  6. 将 invoiceDirectory 和 workbookLocation 变量的值更改为指向示例的安装位置。

  7. 选择项目“NorthwindInvoice”。

  8. 在“项目”菜单上单击“NorthwindInvoice 属性”。

  9. 单击“设置”选项卡。

  10. 在“设置”页上,将 RollupLocation 的值更改为指向 NorthwindOrderRollup.xls 在计算机上的位置。

  11. 按 F5。

  12. 在操作窗格上选择产品类别。

  13. 从工作表中选择一个产品,然后单击“Order”(订单)。

  14. 在对话框中键入一个正数,然后单击“OK”(确定)。

  15. 在操作窗格上单击“查看购物车”。

    可以从订单中删除产品或更改数量。

  16. 单击“继续购物”向订单添加更多产品。

    — 或 —

    单击“签出”完成订单。

  17. 在对话框中键入送货信息,然后单击“确定”提交订单。

    订单将提交到 Northwind Web 服务。

  18. 若要查看所有产品的订单历史记录,请打开 Northwind 订单汇总工作簿,然后查看操作窗格上可用的报表。

  19. 若要为订单创建发票,请打开 Northwind 网站,单击一个订单 ID,然后单击“创建发票”。

    Northwind 网站从 Northwind 订单汇总工作簿中的数据缓存中读取订单数据,然后将该数据保存在从 Northwind 发票模板创建的新文档中。

  20. 若要查看发票,请在网页上单击“查看发票”。

    — 或 —

    打开位于 NorthwindInvoice\bin 或 NorthwindInvoice\bin\Debug 文件夹中的新 Word 文档。

  21. 若要创建另一张发票,请打开 Northwind 发票模板,选择一个客户和一个订单 ID,然后单击“确定”。

要求

  • SQL Server 数据库 Northwind。

演示

  • 从一个 SQL Server 数据库读取数据。

  • 受保护工作表的数据绑定列表。

  • 使用 Windows 窗体。

  • 使用操作窗格。

  • 缓存数据集。

  • 缓存自定义业务对象。

  • Visual Studio Tools for Office 文档的服务器端处理。

  • 使用 Word XMLNodes 宿主控件。

  • 使用 Excel 数据验证。

  • 确定当前客户机处于联机状态还是脱机状态。

  • 调用 Web 服务。

请参见

概念

缓存数据

访问服务器上的文档数据

操作窗格概述

宿主项和宿主控件概述

其他资源

文档级示例