.NET 3.5中MSChart组件的ImageLocation属性含义

在.NET程序/网站中如果要生成统计图表/图形，以前可以采用OWC（Office Web Components），如OfficeXP组件OWC10、Office2003组件OWC11。OWC采用COM-DLL方式的调用接口，但主要缺憾是生成的图片不够美观，不够“现代”。

现在，随着.NET 3.5的发布，其引入了新的MSChart组件，当然，已经彻底的.NET化了。

 

一、要使用这个新的图形组件，需要.NET 3.5 SP1环境。
下载安装以下文件，分别是组件安装包、中文语言包、VS插件。
MSChart.exe
MSChartLP_chs.exe
MSChart_VisualStudioAddOn.exe
还有官方的文档，但目前是英文的。

 

二、言归正传，现在来搞清楚ImageLocation属性的意思。
Chart.ImageLocation
名称空间：System.Web.UI.DataVisualization.Charting
程序集：System.Web.DataVisualization(system.web.datavisualization.dll)
在VS2008中，其默认值为：ChartPic_#SEQ(300,3)
这个好像不太好理解啊:(
好吧，先看几个关联属性吧

1、Chart.RenderType
此属性决定MSChart生成的图形以何种方式送到客户端，有三种：
ImageTag，图形在服务端保存为临时文件，并将临时文件的URL作为HTML中<IMG>标签的SRC属性值。而此临时文件的URL规则及临时文件如何生成可由ImageLocation属性确定。
BinaryStreaming，不在服务端生成图形文件，<IMG>标签的SRC属性值将指向另一个负责生成图形的.aspx页面。
ImageMap，不显示实际的图形，仅创建图片热区（image map）。
默认值是ImageTag，就是会在服务端生成临时文件。

 

2、Chart.ImageStorageMode
此属性决定生成图形的存储方式，有两个选项：
UseHttpHandler，默认值，由HTTP处理程序存储图形文件到内存或文件。但生成的文件客户端是不能够直接能过URL访问到的，<IMG>标签的SRC属性值形如：
ChartImg.axd?i=chart_67fdbfec448349e686916b97f1351e90_0.png&amp;g=f96eecccd0334d70b8c9b0702894182b
并不指向服务端一个物理存储位置。
UseImageLocation，作为临时文件存储在服务端指定位置。在客户端可以通过URL直接获取到图片。可进一步指定图片存储目录位置。图片文件名可以是随机性的也可以是固定的。

 

3、Chart.ImageType
生成图形文件的格式，可以是BMG、JPEG、PNG、EMF。

现在回到Chart.ImageLocation，其实在上面已经提到了它的作用，就是决定图形临时文件的URL规则及临时文件如何生成。
(1)、这个属性只有在Chart.ImageStorageMode=UseImageLocation才有效。
(2)、当Chart.RenderType=ImageTag时，图形文件生成后会在服务端保存。文件格式和扩展名由Chart.ImageType指定。而文件名则可以是静态不变或动态变化的。静态就是使用一个固定名称，动态则使用一个随机名称，可以通过“#”标记来选择使用GUID或指定数字序列来确定一个唯一的文件命名。
(3)、默认值ChartPic_#SEQ(300,3)的含义是
(4)、ImageLocation命名举例，假设Chart.ImageType=Png
属性值                生成图形文件URL              
---------------------------------------------------------------- 
ChartPic_#SEQ(300,3)  ChartPic_000003.png?d155074d-2120-49db-a95c-6a4a61911315           
ChartPic              ChartPic.png?27194803-a8a9-4c3e-81a7-5534a279dbe0  
ChartPic#NOGUIDPARAM  ChartPic.png
(5)、默认值ChartPic_#SEQ(300,3)说明
ChartPic_是前缀，#SEQ是数字序列，300表示最多允许保存300个文件，3代表3秒种，表示向事件日志中写入警告信息的时间限制。

 

三、web.config关联配置项
只有当Chart.ImageStorageMode=UseHttpHandler时，web.config中的配置才会生效。即指定由HTTP处理程序来存储图形文件时，web.config中的配置才会生效。
例如：
<add key="ChartImageHandler" value="storage=file;timeout=20;dir=c:/TempImageFiles/;deleteAfterServicing=false; webDevServerUseConfigSettings=false" />
显然，其中c:/TempImageFiles/就是HTTP处理程序来存储图形文件的目录。
deleteAfterServicing，在图片被浏览器成功下功下载后，确定服务器上图片是否删除，默认值为false。
但请注意，如果不指定deleteAfterServicing，图片是不会被存储为文件的，应当只是暂存在内存中。
webDevServerUseConfigSettings，当在VS开发服务器中，即运行在完全信任级别（full trust level）环境时，决定生成的图片是否被保存在内存中。

 

四、注意文件夹的权限
只要在服务端生成图形文件，无论存储在哪个目录下，ASP.NET帐户都需要拥有该目录的写入权限。

参考：
1、MSChart(.NET 3.5)官方文档。
2、MSDN论坛：http://social.msdn.microsoft.com/Forums/en-US/MSWinWebChart/thread/09815478-c828-4dad-b57e-39522cea9e15