.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&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帐户都需要拥有该目录的写入权限。
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。