在开发项目之前一定要配置好 Web.config:
- 打开 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" -->
<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="x"/>
</controls>
</pages>
<httpModules>
<add name="FineUIScriptModule" type="FineUI.ScriptModule, FineUI"/>
</httpModules>
<httpHandlers>
<add verb="GET" path="res.axd" type="FineUI.ResourceHandler, FineUI"/>
</httpHandlers>
- 完成。
特别提醒
基于.Net 4.5的项目,一定要为Web.config中<page>标签添加controlRenderingCompatibilityVersion和clientIDMode两个属性。
<pages controlRenderingCompatibilityVersion="3.5" clientIDMode="AutoID">
<controls>
<add assembly="FineUI" namespace="FineUI" tagPrefix="ext" />
</controls>
</pages>
注意引用的Newtonsoft.Json.dll版本
FineUI.dll只有一个For Net2.0的版本,无论你的项目是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。