Excel Services OverView系列－－3使用Excel Web Services操作Excel工作薄

Excel Web Services(以后简称EWS)位于整个Excel Services的前端(可以参考我之前的文章)。它提供了开发Excel的接口。从名字可以看出,EWS也属于WebService的一种，所以我们可以像使用普通的WebService那样使用它。要想调用EWS，先要知道它的地址，这取决于MOSS的设置。假如MOSS的名称为ServerName,那么对应的EWS地址就是: http://<server name>/_vti_bin/ExcelService.asmx .在浏览器中输入EWS地址后您会看到下图:

<shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><stroke joinstyle="miter"><formulas><f eqn="if lineDrawn pixelLineWidth 0"><f eqn="sum @0 1 0"><f eqn="sum 0 0 @1"><f eqn="prod @2 1 2"><f eqn="prod @3 21600 pixelWidth"><f eqn="prod @3 21600 pixelHeight"><f eqn="sum @0 0 1"><f eqn="prod @6 1 2"><f eqn="prod @7 21600 pixelWidth"><f eqn="sum @8 21600 0"><f eqn="prod @7 21600 pixelHeight"><f eqn="sum @10 21600 0"></f><path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"><lock aspectratio="t" v:ext="edit"></lock><shape id="Picture_x0020_1" style="VISIBILITY: visible; WIDTH: 248.25pt; HEIGHT: 558pt" type="#_x0000_t75" o:spid="_x0000_i1026"><imagedata o:title="webService" src="file:///C:%5CDOCUME%7E1%5Clancer%5CLOCALS%7E1%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_image001.png"></imagedata></shape></path></f></f></f></f></f></f></f></f></f></f></f></formulas></stroke></shapetype>

话不多说，现在进入今天的主题，我将通过一个程序为您演示如何使用EWS.

本次程序依然會使用上一篇文章里创建的Excel文档。程序运行后首先读取SharePoint Server上的Excel工作薄，将A1至B3的单元格内容显示到程序界面；也可以修改文本框中的内容，然后点击“计算”按钮,对应的标签会显示更新结果；或者点击保存，将服务器上的Excel工作薄保存到本地。
<shape id="Picture_x0020_2" style="VISIBILITY: visible; WIDTH: 225pt; HEIGHT: 225pt" type="#_x0000_t75" o:spid="_x0000_i1025"><imagedata o:title="applicaiton_excelWebService" src="file:///C:%5CDOCUME%7E1%5Clancer%5CLOCALS%7E1%5CTemp%5Cmsohtmlclip1%5C01%5Cclip_image002.png"></imagedata></shape>

现在开始创建应用程序。首先建立一个名为ExcelWebServcice的Windows应用程序，将刚才EWS引用到程序里，将命名空间改为ExcelWebServcice

添加完引用以后就可以使用该服务了。

整个程序分为3部分：1、取值 ； 2、赋值 ； 3、保存 。

<!--[if !supportLists]-->1. <!--[endif]-->取值 ：

将EWS添加到工程后，可以看见ExcelWebService命名空间下出现了ExcelService类。通过操作它就可以完成与服务器端的交互。

首先将其实例化

ExcelService es=new ExcelService();

在调用ExcelService前必须为其指定凭证（Credential），否则应用程序会抛出异常。凭证可以是默认凭证或使用指定了用户名/密码的凭证,这里我们使用默认凭证。两者的区别将在后文讨论。

es.Credentials = System.Net.CredentialCache.DefaultCredentials;

es.Credentials = new System.Net.NetworkCredential("userName", "password","domain");

设置凭证以后我们执行OpenWorkbook，该方法的函数声明如下：

string ExcelService.OpenWorkbook(string workbookPath, string cultrueInfo,string cultrueInfo,string out status)

OpenWorkbook用于打开Excel，workbookPath表示文件在服务器中的地址。cultureInfo,cultureInfo是区域信息，这里我们填写”zh-cn”(代表中文)。最后一个参数有点特殊，是个Status类型的数组，用于存储错误信息。在执行ExcelService的方法时可能会发生错误。严重的错误会引起程序崩溃，而轻微的错误并不影响程序的运行，系统会将错误信息储存在Status类型的数组中。值得注意的是ExcelService类中的所有方法都涉及了该参数。

最后介绍一下该方法的返回值：执行Openworkbook后，Excel Calculation Server会产生一个会话。会话编号就存储在OpenWorkbook的返回值内。

顺利执行 OpenWorkbook 后就可以从 Excel 取值了。我们需要从文档的 sheet1 的第一个单元格取值，也就是从 A1 单元格中取值。可以使用 GetCellA1 方法 .

object GetCellA1(string sessionID,string sheetName,string rangeName,bool formatted,out Status[] status)

GetCellA1方法需要会话的编号，去定从哪个会话的Excel工作薄中取值；参数sheetName确定从哪个sheet中取值；参数rangeName确定从哪个单元格中取值；参数formatted表示取值时是否保留格式;

看到这里您可能会有些疑问：GetCell和GetCellA1有什么区别呢？A1有什么含义？

实际上GetCellA1方法中的A1代表Excel的命名规则。例如您在Excel中的某个单元格内输入”=A1”或者” =Sheet1!$A$1” ，表示该单元格引用了A1单元格的值，仅此而已。

Excel Calculation Service还支持另外一种规则：通过坐标系取/赋值。这种规则对应GetCell方法。只不过现在的坐标系起始值是0，不是Excel中的1。所以我们代码应该如下：

Es.GetCell(workbookPath,”sheet1”,0,0,true,out status);

取值完毕后还需要关闭工作薄,以便释放资源，减轻服务器负担

es.CloseWorkbook(sessionID)

取值部分已经介绍完了，看一下完整代碼：

string workbookPath = @"http://vistaserver/dc/ExcelServiceTest/test.xlsx";

string cultrueInfo = "zh-cn";

Status[] status;

/// <summary>

/// 从服务器上的excel文档中取值

/// </summary>

void GetValueFromServer()

{

ExcelService es = new ExcelService();

es.Credentials = System.Net.CredentialCache.DefaultCredentials;

string sessionID = es.OpenWorkbook(workbookPath, cultrueInfo, cultrueInfo, out status);

A1Field.Text = es.GetCellA1(sessionID, "sheet1", "A1", true, out status).ToString();

A2Field.Text = es.GetCellA1(sessionID, "sheet1", "A2", true, out status).ToString();

A3Field.Text = es.GetCellA1(sessionID, "sheet1", "A3", true, out status).ToString();

number1.Text = es.GetCellA1(sessionID, "sheet1", "B1", true, out status).ToString();

number2.Text = es.GetCellA1(sessionID, "sheet1", "B2", true, out status).ToString();

result.Text = es.GetCellA1(sessionID, "sheet1", "B3", true, out status).ToString();

es.CloseWorkbook(sessionID);

}

<!--[if !supportLists]-->2. <!--[endif]-->赋值：

ExcelService类中对单元格赋值的方法为SetCellA1（还有SetCell，使用方法可以参考GetCell）。该方法的函数声明如下

Status status=SetCellA1(string sessionID,string sheetName,string rangeName,object cellValue)

看一下计算部分的完整代码:

ExcelService es = new ExcelService();

es.Credentials = System.Net.CredentialCache.DefaultCredentials;

string sessionID = es.OpenWorkbook(workbookPath, cultrueInfo, cultrueInfo, out status);

es.SetCellA1(sessionID, "sheet1", "B1", number1.Text);

es.SetCellA1(sessionID, "sheet1", "B2", number2.Text);

result.Text = es.GetCellA1(sessionID, "sheet1", "B3", true, out status);

<!--[if !supportLists]-->3. <!--[endif]-->保存

您可能注意到了，“赋值”部分的代码缺少了CloseWorkbook方法。其原因可以从上文中联想到：Excel Calculation Service负责维护会话，这样可以保证多个用户使用Excel Calculation Service时不会相互影响。所以关闭了工作薄会导致会话也被关闭，之前在会话中对Excel所作的操作也将丢失… 所以，保存操作要在关闭会话前完成。

现在看一下获取Excel工作薄的方法：

byte[] GetWorkbook(string sessionID,WorkbookType workbookType,out Status[] status)

GetWorkbook从服务器端获取Excel工作薄，将其以byte数组的形式返回。该方法包含3个参数。想必大家对参数sessionID和status的用法比较熟悉了，这里我着重讲解以下WrokbookType的含义。

WorkbookType是一个枚举类型：

public enum WorkbookType

{

FullWorkbook,

FullSnapshot,

PublishedItemsSnapshot,

}

FullWorkbook功能最强大，可以获得服务器上完整的工作薄（所有的sheet）

FullSnapshot和FullWorkbook类似，也可以获得完整的工作薄快照

PublishedItemsSnapshot功能最弱，只能获得作者允许查看的的工作薄的快照(还记得上一篇文章里提到的”ExcelService选项”吗)

看到这里，大家可能有点疑惑：只要设置了 FullWorkbook 或 FullSnapshot 就可以获得完整的工作薄，那作者在发布 Excel 时进行的工作不就没用了吗？呵呵，实际上并不是任何人（或者说任何情况下）都可以使用 FullWorkbook/FullSnapshot 的。记得之前我提到的“凭证”吗？ 只有提供了足够的权限的凭证才可以使用。

再来说说“完整工作薄”和“快照”的区别。可以将快照理解为前者的子集。但快照不能使用创建者在工作薄中输入的公式，并且不能使用外部数据连接。

Ok ， GetWorkbook 方法介绍完毕，看一下程序代码。

byte[] content = es.GetWorkbook(sessionID, WorkbookType.PublishedItemsSnapshot, out status);

es.CloseWorkbook(sessionID);

FileStream fs = new FileStream("c:\\test.xlsx", FileMode.Create);

fs.Write(content, 0, content.Length);

fs.Flush();

fs.Close();

现在，程序的整体功能已经完成了。希望能对大家有所帮助。

我只介绍了Excel Web Service的基本使用方法，本想在程序里添加更多的功能，全面介绍一下Excel Web Service中的方法。但我实在不知道如何表达出来：（ 我将在一篇文章中为大家介绍user-defined functions (UDFs). 再次感谢大家浏览。

by stswordman