在开发项目之前请配置好 Web.config:
- 设置 configuration 配置节:
<configSections>
<section name="FineUI" type="FineUI.ConfigSection, FineUI"/>
</configSections>
<!-- 可用的配置项(这里列的都是默认值):
Theme="Neptune"
Language="zh_CN"
AjaxTimeout="120"
EnableAjax="true"
DebugMode="false"
FormMessageTarget="Qtip"
FormOffsetRight="0"
FormLabelWidth="100"
FormLabelSeparator=":"
FormLabelAlign="Left"
EnableAjaxLoading="true"
AjaxLoadingType="Default"
CustomTheme=""
IconBasePath="~/res/icon"
CustomThemeBasePath="~/res/theme"
JSBasePath="~/extjs"
IEEdge="true"
-->
<FineUI DebugMode="false" />
FineUI 配置节中的参数:
- Theme: 控件主题,内置 4 种主题风格(Neptune/Blue/Gray/Access,默认值:Neptune)
- Language: 控件语言(en/zh_CN/zh_TW,默认值:zh_CN)
- FormMessageTarget: 表单字段错误提示信息的显示位置(Title/Side/Qtip,默认值:Side)
- FormOffsetRight: 表单字段右侧距离边界的宽度(默认值:0px)
- FormLabelWidth: 表单字段标签的宽度(默认值:100px)
- FormLabelSeparator: 表单字段标签与内容的分隔符(默认值:":")
- EnableAjax: 是否启用AJAX(默认值:true)
- AjaxTimeout: Ajax超时时间(单位:秒,默认值:120s)
- DebugMode: 是否开发模式,启用时格式化输出页面的JavaScript代码,便于调试(默认值:false)
- EnableAjaxLoading: 是否启用Ajax提示(默认值:true)
- AjaxLoadingType: Ajax提示类型,默认在页面顶部显示黄色提示框(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。