如何:保存到服务器以准备进行编程访问

本示例介绍如何将 Excel 工作簿保存到服务器,以使其为接下来的编程访问做好准备。这些步骤是:

  1. 创建包含命名区域的工作簿。

  2. 将工作簿保存到受信任的 SharePoint 库位置。

    备注

    假定您已经创建了 SharePoint 文档库,并使其成为受信任的位置。有关此操作的详细信息,请参阅如何:信任一个位置如何:使用脚本信任工作簿位置

  3. 使用 Excel Web ServicesSetCellA1 方法以编程方式指定工作表、命名区域和单元格的值。这些值作为参数传入,即 args [1] 和 args [2]:

    status = xlServices.SetCellA1(sessionId, String.Empty, args[1], args[2]);
    

可以使用 Web 窗体或命令行指定 args [1] 和 args [2] 的值:

GetSnapshot.exe http://MyServer002/MyTrustedDocumentLibrary/TestMyParam.xlsx MyParam 28 > MySnapshot.xlsx 

在此示例中,args [1] 是“MyParam”,args [2] 是“28”,而“GetSnapshot.exe”是您创建的应用程序的名称。若要找一个示例程序,请参阅如何:获取整个工作簿或快照

创建命名区域

  1. 启动 Microsoft Office Excel 2007。

  2. 将“Sheet1”重命名为“MyParamSheet”。

  3. 在单元格 B2 中键入 20。

  4. 在单元格 B3 中键入 =2+B2。

  5. 将单元格 B3 变为粗体。

  6. 将单元格 B2 变为命名区域。单击菜单上的“公式”。然后单击单元格 B2 以将其选中。在“公式”菜单上单击“命名单元格区域”。在“新名称”对话框的“名称”框中键入“MyParam”。

  7. 将工作簿保存到本地驱动器上您所选择的位置。并将工作簿命名为“TestMyParam.xlsx”。

保存到 SharePoint 库

  1. 单击“Microsoft Office 按钮”,指向“发布”,然后单击“Excel Services”。

  2. 在“另存为”对话框中单击“Excel Services 选项”。

  3. 在“Excel Services 选项”对话框的“显示”选项卡上确保选中“整个工作簿”。

  4. 单击“参数”。

  5. 单击“添加”。

  6. 在“添加参数”列表中应该看到“MyParam”。选中“MyParam”复选框。

  7. 单击“确定”。现在应该在“参数”列表中看到“MyParam”。

  8. 单击“确定”。

  9. 在“另存为”对话框中清除“在 Excel Services 中打开”复选框。

  10. 在“文件名”框中键入要存储此工作簿的受信任 SharePoint 文档库的路径。例如 http://MyServer002/MyDocumentLibrary/TestParam.xlsx。

  11. 单击“保存”。

以编程方式指定值

  1. Excel Web Services 中 SetCellA1 方法的签名是:

    public void SetCellA1 (
    string sessionId,
    string sheetName,
    string rangeName,
    Object cellValue,
    Out Status[] status
    )
    

    按如下方式向 SetCellA1 方法设置工作表、命名区域单元格的值:

    // Set a value into a cell.
    status = xlSrv.SetCellA1(sessionId, String.Empty, args[1], args[2]);
    
  2. 在前面的代码中:

    • args [1] 是命名区域的名称。此例中为“MyParam”。

    • args [2] 是单元格中要设置的值。将设置该值的单元格是 args [1] 中名为“MyParam”的命名区域。

  3. 如果使用命令行,则可以按如下方式传入参数:

    GetSnapshot.exe http://MyServer002/MyTrustedDocumentLibrary/TestMyParam.xlsx MyParam 28 > MySnapshot.xlsx

  4. 如果生成工作簿的快照,则将看到以下内容:

    • 单元格 B2(带有命名范围“MyParam”)现在的值为您通过程序提供的值,即“28”。

    • 单元格 B3 有一个新的计算值“30”。

    • 单元格 B3 不显示原始公式,即“=2+B2”。

    • 单元格 B3 保留其字体格式,即粗体。

备注

有关快照的详细信息,请参阅如何:获取整个工作簿或快照。有关 SetCellA1 方法的详细信息,请参阅 Excel Web Services 参考文档。

See Also

任务

如何:从 Excel 客户端保存到服务器

演练:使用 Excel Web Services 开发自定义应用程序

如何:使用脚本信任工作簿位置

概念

访问 SOAP API

环回 SOAP 调用和直接链接

Excel Services 警报