Extaspnet的webconfig配置

### Extaspnet的webconfig配置 #### 概述 在探讨`Extaspnet`的`webconfig`配置之前，我们先来了解下`Extaspnet`本身及其在.NET Web应用程序中的作用。`Extaspnet`是一款基于Ext JS的ASP.NET控件集，它允许开发者在.NET环境中使用Ext JS构建丰富的客户端界面。为了更好地利用这些控件，通常需要对项目的`web.config`文件进行一定的配置。 #### `web.config`中的关键配置项解析 ##### 1. **ExtAspNet配置节** `web.config`中的`<configSections>`部分定义了`ExtAspNet`配置节的类型： ```xml <configSections> <section name="ExtAspNet" type="ExtAspNet.ConfigSection, ExtAspNet" /> </configSections> ``` 接下来是具体的`ExtAspNet`配置： ```xml <ExtAspNet EnableBigFont="true" DebugMode="false" /> ``` - **Theme**：设置主题，默认为`blue`。可选值包括`blue`、`gray`、`access`等。 - **Language**：设置语言，默认为`zh_CN`（简体中文）。可选值还包括`en`（英语）、`zh_TW`（繁体中文）等。 - **FormMessageTarget**：设置表单消息显示的位置，默认为`side`。另一个可选项是`qtip`。 - **FormOffsetRight**：设置表单偏移量，默认为`20`像素。 - **FormLabelWidth**：设置表单标签宽度，默认为`100`像素。 - **FormLabelSeparator**：设置表单标签与输入框之间的分隔符，默认为空。 - **EnableAjax**：启用AJAX，默认为`true`。 - **AjaxTimeout**：设置AJAX请求超时时间，默认为`60`秒。 - **EnableBigFont**：是否使用大字体，默认为`false`。若设置为`true`，则Ext JS字体大小将从11px调整至12px。 - **DebugMode**：启用调试模式，默认为`false`。开启后，可以在浏览器中查看JavaScript错误。 ##### 2. **系统配置** 此外，`web.config`中还包含了以下配置项： - `<pages>`节点用于配置页面级别的设置： - `<controls>`节点用来添加Extaspnet控件： ```xml <add assembly="ExtAspNet" namespace="ExtAspNet" tagPrefix="ext" /> ``` - `<httpModules>`节点用于注册HTTP模块： - `<add>`节点注册了`ExtAspNetScriptModule`模块： ```xml <add name="ExtAspNetScriptModule" type="ExtAspNet.ScriptModule, ExtAspNet" /> ``` - `<httpHandlers>`节点用于注册HTTP处理器： - `<add>`节点注册了处理`res.axd`路径请求的处理器： ```xml <add verb="GET" path="res.axd" type="ExtAspNet.ResourceHandler, ExtAspNet" /> ``` ##### 3. **兼容性配置** 对于.NET 4.0及以上版本的应用程序，还需要配置`<page>`元素的`controlRenderingCompatibilityVersion`和`clientIDMode`属性： ```xml <pages controlRenderingCompatibilityVersion="3.5" clientIDMode="AutoID"> <controls> <add assembly="ExtAspNet" namespace="ExtAspNet" tagPrefix="ext" /> </controls> </pages> ``` 这样可以确保在不同的.NET框架版本之间保持良好的兼容性。 #### 外部依赖配置 在使用`Extaspnet`的过程中，可能还会用到第三方库如`Newtonsoft.Json.dll`。对于不同版本的.NET框架，需要引用不同的库版本： - 对于.NET 2.0版本，需要引用`json.net\Net20\Newtonsoft.Json.dll`。 - 对于.NET 4.0及更高版本，则应引用`json.net\Net40\Newtonsoft.Json.dll`。 通过上述详细的配置，可以有效地利用`Extaspnet`提供的功能，并确保其与.NET应用环境的良好集成。