在开发项目之前请配置好 Web.config:
设置 configuration 配置节:
<configSections> <section name="FineUI" type="FineUI.ConfigSection, FineUI"/> </configSections> <!-- 可用的配置项(这里列的都是默认值):Language="zh_CN" AjaxTimeout="60" EnableAjax="true" Theme="blue" FormMessageTarget="qtip" FormOffsetRight="20" FormLabelWidth="100" FormLabelSeparator=":" IconBasePath="~/icon" EnableAjaxLoading="true" AjaxLoadingType="default" CustomTheme="" CustomThemeBasePath="~/theme" JSBasePath="~/extjs" --> <FineUI DebugMode="false" />
FineUI 配置节中的参数:
Theme: 控件主题,目前内置了四种主题风格(Neptune/Blue/Gray/Access,默认值:Neptune)
Language: 控件语言(en/zh_CN/zh_TW/...,默认值:zh_CN)
FormMessageTarget: 表单字段错误提示信息的显示位置(Side/Qtip,默认值:Side)
FormOffsetRight: 表单字段右侧距离边界的宽度(默认值:5px)
FormLabelWidth: 表单字段标签的宽度(默认值:100px)
FormLabelSeparator: 表单字段标签与内容的分隔符(默认值:":")
EnableAjax: 是否启用AJAX(默认值:true)
AjaxTimeout: AJAX超时时间(单位:秒,默认值:60s)
DebugMode: 是否开发模式,启用时格式化输出页面JavaScript代码,便于调试(默认值:false)
EnableAjaxLoading: 是否启用Ajax提示(默认值:true)
AjaxLoadingType: Ajax提示类型,默认在页面顶部显示黄色提示框,mask则显示extjs默认的加载提示(default/mask,默认值:default)
设置 system.web 配置节:
<pages> <controls> <add assembly="FineUI" namespace="FineUI" tagPrefix="f"/> </controls> </pages> <httpModules> <add name="FineUIScriptModule" type="FineUI.ScriptModule, FineUI"/> </httpModules> <httpHandlers> <add verb="GET" path="res.axd" type="FineUI.ResourceHandler, FineUI" validate="false"/> </httpHandlers>
完成。
特别提醒
基于.Net 4.5的项目,一定要为Web.config中<page>标签添加controlRenderingCompatibilityVersion和clientIDMode两个属性。
<pages controlRenderingCompatibilityVersion="3.5" clientIDMode="AutoID"> <controls> <add assembly="FineUI" namespace="FineUI" tagPrefix="f" /> </controls> </pages>
注意引用的Newtonsoft.Json.dll版本
FineUI.dll只有一个版本,无论你的项目是2.0、3.5、4.0、4.5,都只需要引用同一个FineUI.dll即可。
Newtonsoft.Json.dll为每个.Net版本创建不同的DLL,比如你的项目是基于.Net 2.0的,就要引用json.net\Net20\Newtonsoft.Json.dll,如果你的项目是基于.Net 4.0的,就要引用json.net\Net40\Newtonsoft.Json.dll。