Asp.Net之自定义表达式构造器(ExpressionBuilder)

在Asp.Net的Page页面中我们经常会使用到资源文件。读取资源文件的方式为：<%$Resources:Resource1,Test1%>，这样就可以显示Resource1这个资源文件中的Test1的键值，并且在页面设计过程中就可以正确的显示资源文件中的值了。这里就是使用到了.Net中的表达式构造器，那么它是如何实现的？我们能不能定义自己的表达式构造器呢？本文通过构建一个简单的Xml表达式构造器来说明这一过程。
首先来看看Asp.Net中的表达式构造器是如何实现的
默认在C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\CONFIG\web.config中我们可以找到如下配置节：

      <expressionBuilders>
        <add expressionPrefix="Resources" type="System.Web.Compilation.ResourceExpressionBuilder"/>
        <add expressionPrefix="ConnectionStrings" type="System.Web.Compilation.ConnectionStringsExpressionBuilder"/>
        <add expressionPrefix="AppSettings" type="System.Web.Compilation.AppSettingsExpressionBuilder"/>
      </expressionBuilders>

在这里定义了三个表达式构造器：Resources，ConnectionStrings，AppSettings。因此我们可以在页面中直接使用它们，比如可以使用<%$AppSettings:aa %>来读取AppSettings的配置。注意这里使用的是$符号，它是读取表达式构造器的专用标识。

接下来重点看看如何实现自己的表达式构造器
我们的目的是实现一个简单的Xml表达式构造器，可以读取指定xml文件中的配置信息，并且在页面设计阶段就可以看到效果。
一、修改配置
在自己的web.config中加入配置：

          <expressionBuilders>
            <add expressionPrefix="Xml" type="MyResource.XmlExpressionBuilder, MyResource, Version=1.0.0.0, Culture=neutral, PublicKeyToken=94a835118357b2d3"/>
          </expressionBuilders>

表示我们的表达式构造器的前缀为Xml，也就是在页面中使用<%$Xml:.... %>的方式来读取
我们自定义的表达式构造器类的类名为XmlExpressionBuilder，特别注意这个类所在的程序集需要使用强签名

二、实现表达式构造器类(ExpressionBuilder)
首先我们的类需要从ExpressionBuilder继承

public class XmlExpressionBuilder : ExpressionBuilder

实现GetCodeExpression方法，这个方法是在页面实际运行时计算表达式的值使用的。它是用来为页面初始化生成代码(在允许页面编译时才会调用到此方法，Asp.Net在默认情况下是允许页面编译的)：

        public override CodeExpression GetCodeExpression(BoundPropertyEntry entry, object parsedData, ExpressionBuilderContext context)
        {
            if ((entry.DeclaringType == null) || (entry.PropertyInfo == null))
            {
                return new CodeMethodInvokeExpression(new CodeTypeReferenceExpression(base.GetType()), "GetXmlKey", new CodeExpression[] { new CodePrimitiveExpression(entry.Expression.Trim()) });
            }
            return new CodeMethodInvokeExpression(new CodeTypeReferenceExpression(base.GetType()), "GetXmlKey", new CodeExpression[] { new CodePrimitiveExpression(entry.Expression.Trim()), new CodeTypeOfExpression(entry.DeclaringType), new CodePrimitiveExpression(entry.PropertyInfo.Name) });
        }

这个方法主要就是动态的调用GetXmlKey这个自定义的方法：

        //取得Xml中的key值，为了测试，没有考虑性能和异常的问题
        public static string GetXmlKey(string strKey)
        {
            string[] keys = strKey.Split(',');
            string strFile = HttpContext.Current.Server.MapPath("/") + keys[0] + ".xml";
            
            XmlDocument xmlDoc = new XmlDocument();
            xmlDoc.Load(strFile);
            XmlNodeList nodeList = xmlDoc.SelectSingleNode("test").ChildNodes;
            foreach (XmlNode xn in nodeList)
            {
                if (xn is XmlElement)
                {
                    if (xn.Name == keys[1])
                    {
                        return (xn as XmlElement).GetAttribute("value");
                    }
                }
            }
            return "";
        }
        public static object GetXmlKey(string key, Type targetType, string propertyName)
        {
            return GetXmlKey(key);
        }

在这里定义key值的格式为逗号分割的方式，比如在页面中调用<%$Xml:test,test1 %>，那么传递过来的参数strKey=test,test1

实现EvaluateExpression和SupportsEvaluate方法，这两个方法是在禁用页面编译时才会调用的，比如在页面中设置如下：

<%@ Page Language="C#"  CodeBehind="Default.aspx.cs" Inherits="MyResource._Default" CompilationMode="Never" %>

这种情况下就会调用这两个方法来取得表达式的值：

        //返回一个值，该值指示是否可在不编译的页中计算表达式
        public override bool SupportsEvaluate
        {
            get
            {
                return true;
            }
        }
        //返回当前表达式的计算结果（禁用页面编译时 ---CompilationMode="Never" ）
        public override object EvaluateExpression(object target, BoundPropertyEntry entry, object parsedData, ExpressionBuilderContext context)
        {
            return GetXmlKey(entry.Expression, target.GetType(), entry.PropertyInfo.Name);
        }

<?xml version="1.0" encoding="GB2312"?>
<test>
  <test1 value="测试1"/>
  <test2 value="测试2" />
</test>

最后在自己的Aspx页面中调用：

        <asp:Label ID="Label1" runat="server" Text="<%$Xml:test,test1 %>"></asp:Label>
        <br />
        <asp:Label ID="Label3" runat="server" Text="<%$Xml:test,test2 %>"></asp:Label>
        <br />

运行此页面就可以正确的显示test.xml中对应的值了。不过现在还有一个问题就是在页面的设计界面不能正确的显示test.xml中的值，因此我们还要接下来实现表达式编辑器类。

三、实现表达式编辑器类(ExpressionEditor)
首先在XmlExpressionBuilder上加入类属性，指定使用哪个表达式编辑器类

    [ExpressionEditor("MyResource.XmlExpressionEditor, MyResource, Version=1.0.0.0, Culture=neutral, PublicKeyToken=94a835118357b2d3"), ExpressionPrefix("Xml")]
    public class XmlExpressionBuilder : ExpressionBuilder

接下来实现自己的表达式编辑器类：XmlExpressionEditor，它必须从ExpressionEditor继承

public class XmlExpressionEditor : ExpressionEditor

在我们的例子中只需要实现EvaluateExpression这个方法就可以了，它就是用来在页面的设计阶段来取得表达式的值的

        public override object EvaluateExpression(string expression, object parseTimeData, Type propertyType, IServiceProvider serviceProvider)
        {
            if (serviceProvider != null)
            {
                IWebApplication service = (IWebApplication)serviceProvider.GetService(typeof(IWebApplication));
                if (service != null)
                {
                    System.Configuration.Configuration configuration = service.OpenWebConfiguration(true);
                    if (configuration != null)
                    {
                        string strFile = configuration.FilePath.Substring(0, configuration.FilePath.LastIndexOf("\\"));
                        string[] keys = expression.Split(',');
                        strFile = strFile + "\\" + keys[0] + ".xml";
                        return XmlExpressionBuilder.GetXmlKey(expression, strFile);
                    }
                }
            } 
            
            return "";
        }

在这里也是通过调用XmlExpressionBuilder类中的GetXmlKey方法的，但是由于在设计状态下是取不到HttpContext.Current的值的，因此在这个方法中我通过IServiceProvider接口来取得当前路径，将得到xml文件名作为参数传递给GetXmlKey方法。修改后的GetXmlKey方法如下：

        //取得Xml中的key值，为了测试，没有考虑性能和异常的问题
        public static string GetXmlKey(string strKey, string strFileName)
        {
            string[] keys = strKey.Split(',');
            string strFile = "";
            if (String.IsNullOrEmpty(strFileName))
            {
                strFile = HttpContext.Current.Server.MapPath("/") + keys[0] + ".xml";
            }
            else
            {
                strFile = strFileName;
            }
            XmlDocument xmlDoc = new XmlDocument();
            xmlDoc.Load(strFile);
            XmlNodeList nodeList = xmlDoc.SelectSingleNode("test").ChildNodes;
            foreach (XmlNode xn in nodeList)
            {
                if (xn is XmlElement)
                {
                    if (xn.Name == keys[1])
                    {
                        return (xn as XmlElement).GetAttribute("value");
                    }
                }
            }
            return "";
        }
        public static object GetXmlKey(string key, Type targetType, string propertyName)
        {
            return GetXmlKey(key, "");
        }
        public static string GetXmlKey(string strKey)
        {
            return GetXmlKey(strKey, "");
        }

这样就可以在页面的设计视图取得正确的值了(当修改了XmlExpressionEditor文件后，重新编译后可能在设计视图还是不能正确显示，需要把VS2005重新启动一下就可以了)