演练:使用 Excel Web Services 开发自定义应用程序
本节中的演练说明从使用 Microsoft Visual C# 创建的应用程序访问 Excel Web Services 的过程。
在本演练中,您将学习如何:
使用 Visual Studio 控制台应用程序项目模板创建客户端应用程序。
添加对 Excel Web Services 的 Web 引用。
编写访问 Web 服务的代码。 您将了解如何打开工作簿、获取会话 ID、传递默认凭据、获取 Web 服务版本信息、定义范围协调对象、获取使用范围协调对象的范围、关闭工作簿以及捕获 SOAP 异常。
在调试模式下测试和运行控制台应用程序。
客户端控制台应用程序只是访问 Web 服务的一种方式。 更常见的方式是使用服务器应用程序,例如 Microsoft ASP.NET 应用程序。 为简单起见,本演练使用控制台应用程序,重点关注 Excel Web Services API 方面。
先决条件
要完成本演练,您将需要:
Microsoft SharePoint Server 2010。
Visual Studio 或与 Microsoft .NET Framework 兼容的相似开发工具。
能够访问 SharePoint Server 2010 所在的计算机上的 Excel Web Services 的足够权限(至少为"查看"权限)。
注意
若要详细了解工作簿权限,请参阅下一部分“工作簿权限”。
安装在本地驱动器或本地 SharePoint 文档库上的示例工作簿。
存储您想使用 Excel Web Services 访问的工作簿的受信任位置。 如果工作簿未存储在受信任位置,打开工作簿的 Excel Web Services 调用将失败。 本演练假定工作簿存在于本地计算机上。
注意
有关如何信任位置的信息,请参阅 如何:信任位置 和 如何:使用脚本信任工作簿位置。
使用 Excel 创建工作簿的具体步骤。
将工作簿另存为 .xlsx 或 .xlsb 文件。
本示例中使用的工作簿具有一个名为"Sheet1"的工作表。 该工作表中有 11 列和 19 行。 从 A1 到 K19 每个单元格均包含一个数值—例如,4245.955、6960.673,等等。
工作簿权限
要获取整个工作簿(例如,通过调用 GetWorkbook 方法),调用者需要具备工作簿的"打开"权限。
调用 GetApiVersion 方法无需权限。
对于其余 Excel Web Services 方法,调用者需要具备工作簿的"查看"权限(在 Microsoft SharePoint Foundation 中)或"读取"权限(在文件共享中)。
注意
若要详细了解如何设置权限,请参阅 SharePoint Foundation 文档。