.NET实现Office Excel自定义公式 广泛应用于报表与数据分析

在管理软件开发的功能点中，有相当一部分功能是与Excel做数据交互，产生Excel 数据报表。如果Excel报表的数据计算方法很有规律可循，则可以通过自定义公式来解决。比如常见的资产负债表，利润表，取数都非常有规律。

Excel DNA是一套用.NET框架实现的Excel自定义公式引擎，互联网上有很多Excel财务方面的报表是基于此技术实现。Excel DNA完全开放源代码，可到网上下载它的完整源代码和例子工程，地址是https://exceldna.codeplex.com 

 

开发自定义公式

1 创建用户自定义公式(Visual Basic)

用记事本创建一个Test.dna的文本文件，参考下面的代码例子，实现一个简单的加法公式。

  <DnaLibrary>
    <![CDATA[
        Public Module MyFunctions
            Function AddThem(x, y)
                AddThem = x + y
            End Function
        End Module
    ]]>
    </DnaLibrary>

打开Excel，输入公式=AddThem(4,2)，可以看到Excel计算后的公式结果是6。

 

2 创建自定义公式(C#)

创建一个Test.dna的文本文件，参考如下所示的例子代码，实现字符串与双精度类型数值相加的公式。

  <DnaLibrary Language="CS">
    <![CDATA[
        using ExcelDna.Integration;
                public class MyFunctions
                {
                        [ExcelFunction(Description="Joins a string to a number", Category="My functions")]
                        public static string JoinThem(string str, double val)
                        {
                                return str + val;
                        }
                }
    ]]>
    </DnaLibrary>

可以打开Excel，输入公式=JoinThem(“James”,1983)，可看到实际的运算结果。

 

3  通过.NET程序集创建自定义公式

Visual Basic,C#都是.NET的一等公民，用自己熟悉的语言创建一个Class Library类库项目TestLib，参考如下的代码例子，实现两个双精度数值相加的公式。

using ExcelDna.Integration;
public class MyFunctions
{
        [ExcelFunction(Description="Multiplies two numbers", Category="Useful functions")]
        public static double MultiplyThem(double x, double y)
        {
                return x * y;
        }
}

再来创建一个Test.dna的文本文件，添加如下的文本片段，用于声明前面创建的公式。

<DnaLibrary>
    <ExternalLibrary Path="TestLib.dll" />
</DnaLibrary>
打开Excel，输入公式=MultiplyThem(2,3) 或=MultiplyThem(2; 3)，看到计算结果是5。

如果.NET程序集编译成.NET 4.0，则需要稍微修改一下Test.dna的文本内容，参考下面的例子。

 <DnaLibrary RuntimeVersion="v4.0" >
      <ExternalLibrary Path="TestLib.dll" />
 </DnaLibrary>

 

部署 Deployment

拷贝一份文件ExcelDna.xll到需要的目录中，重命名为需要的名字，比如上面的Test.xll，将上面的Test.dna文件也放到同一个文件中。双击xll文件会打开Excel程序，

提示安全声明，选为本会话启用此加载项。

然后就可以使用自定义的公式，打开或新建一个Excel文件，输入公式，回车后执行公式。

TestClassLibrary程序集中自定义公式的方法的源代码。要编译必须引用程序集ExcelDna.Integration.dll。

[ExcelFunction(Description="My first Excel-DNA function")]
public static string MyFirstFunction(string name)
{
    return ("Hello " + name);
}

Test.dna文件的内容如下，只是简单的声明上面的程序集中的方法。

<DnaLibrary Name="First Add-In" RuntimeVersion="v4.0">
  <ExternalLibrary Path="TestClassLibrary.dll" />
</DnaLibrary>

 

打包 Packing

注意在部署时，必须同时存在dna文件和xll文件，而且这两个文件的名字要完全相同。Excel DNA支持将这两个文件合并打包在一个文件中。

运行程序ExcelDna\Distribution\ExcelDnaPack.exe，并传入参数Test.dna。如下的命令所示例的：

ExcelDnaPack.exe， Test.dna

执行完成之后，会生成一个Test-packed.xll文件，这个文件可以拷贝到其它电脑中直接执行。Test-packed.xll中已经包含Test.dna和TestLibrary.dll文件，运行时会主动被加载。

 

抛开复杂的Visual Studio Tools for Office, 凭借这几天简单的例子，我想读者应该可以快速的上手，高效率的创作Excel中的自定义公式。

 

界面(Ribbon,Panel)与COM服务器支持

Excel DNA支持创建一个自定义的面板，添加一个WinForms自定义控件，继承于System.Windows.Forms.UserControl，再添加下面的码调用即可。

CustomTaskPane myCTP = CustomTaskPaneFactory.CreateCustomTaskPane(typeof(MyUserControl), myTitle

更多内容可参考下载的源代码包，有详细的例子和说明文档。