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

时间:2023-03-09 05:40:47
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[] + ".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[])
{
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);
}

附测试的test.xml文件

<?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继承

在我们的例子中只需要实现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(, configuration.FilePath.LastIndexOf("\\")); string[] keys = expression.Split(','); strFile = strFile + "\\" + keys[] + ".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[] + ".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[])
{
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重新启动一下就可以了)

转自:http://www.cnblogs.com/firstyi/archive/2008/08/05/1260844.html