现在的位置: 首页 > 综合 > 正文

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

2013年01月12日 ⁄ 综合 ⁄ 共 2716字 ⁄ 字号 评论关闭

 在.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

本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/tjianliang/archive/2009/02/13/3888094.aspx

 

抱歉!评论已关闭.