Community中的程序配置
类别: ASP.NET教程
程序采用多个配置文件,现简要介绍心下几个元素
1 .1 <pages> 元素
<pages validateRequest="false" />
标识特定于页的配置设置
validateRequest:指示 ASP.NET 在从浏览器输入的所有内容中检查是否存在潜在的危险数据。如果是 true,则将所有输入数据与一个潜在危险值列表进行比较,从而执行请求验证。如果发生匹配,ASP.NET 将引发 HttpRequestValidationException 异常。
1 .2 <httpModules> 元素
<httpModules>
<add name="CommunitiesModule"type="ASPNET.StarterKit.Communities.CommunitiesModule,ASPNET.StarterKit.Communities"
>
/httpModules>
在一个应用程序内配置 HTTP 模块。
HttpModule:HttpModule 是实现 IHttpModule 接口和处理事件的程序集。ASP.NET 包含一组可由应用程序使用的 HttpModule 模块。例如,ASP.NET 提供了 SessionStateModule 来向应用程序提供会话状态服务。可以创建自定义 HttpModule 以响应 ASP.NET 事件或用户事件。
编写 HttpModule 的一般过程为:
实现 IHttpModule 接口。
处理 Init 方法并为所需事件进行注册。
处理该事件。
如果必须进行清理,还可根据需要实现 Dispose 方法。
在 Web.config 中注册该模块。
子标记
说明
<add>
将 HttpModule 类添加到应用程序。
请注意,如果以前已指定了相同的谓词/路径组合(例如在父目录的 Web.config 文件中),则对 <add> 的第二个调用将重写以前的设置。
<httpModules>
<add name="OutputCache"
type="System.Web.Caching.OutputCacheModule, System.Web,
Version=1.0.2800.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
</httpModules>
属性
说明
name
为模块提供一个好记的名称。这使您可为 global.asax 文件内的模块事件关联一个事件处理程序。
type
指定由版本、程序集和公钥标记组成的逗号分隔的类/程序集组合。ASP.NET 首先在应用程序的专用 /bin 目录中搜索程序集 DLL,然后在系统程序集缓存中搜索程序集 DLL。
<remove>
从应用程序移除 HttpModule 类。
<clear>
从应用程序移除所有 HttpModule 映射。
1 .3 <httpRuntime> 元素
<httpRuntime maxRequestLength="10000" />
配置 ASP.NET HTTP 运行库设置。该节可以在计算机、站点、应用程序和子目录级别声明。
属性
说明
maxRequestLength
指示 ASP.NET 支持的最大文件上载大小。该限制可用于防止因用户将大量文件传递到该服务器而导致的拒绝服务攻击。指定的大小以 KB 为单位。默认值为 4096 KB (4 MB)。
1 .4 <httpHandlers> 元素
<httpHandlers>
<add verb="*" path="*.jpg" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
<add verb="*" path="*.jpeg" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
<add verb="*" path="*.gif" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
</httpHandlers>
<httpHandlers>
<remove verb="*" path="*.jpg" />
<remove verb="*" path="*.gif" />
</httpHandlers>
根据在请求中指定的 URL 和 HTTP 谓词,将传入的请求映射到适当的 IHttpHandler 或 IHttpHandlerFactory 类。
子标记
说明
<add>
指定映射到 IHttpHandler 或 IHttpHandlerFactory 类的谓词/路径。
属性
说明
verb
谓词列表可以是逗号分隔的 HTTP 谓词列表(例如“GET, PUT, POST”),也可以是开始脚本映射(例如通配符 * [星号])。
path
路径属性可以包含单个 URL 路径或简单的通配符字符串(例如 *.aspx)。
type
指定逗号分隔的类/程序集组合。ASP.NET 首先在应用程序的专用 /bin 目录中搜索程序集 DLL,然后在系统程序集缓存中搜索程序集 DLL。
<remove>
移除映射到 IHttpHandler 类的谓词/路径。<remove> 指令必须与上一个 <add> 指令的谓词/路径组合精确匹配。该指令不支持通配符。
<clear>
移除当前配置的或由指定 Web.config 文件继承的所有 IHttpHandler 映射。
1 .5 <webServices> 元素
<webServices>
<protocols>
<add name="HttpGet"/>
</protocols>
</webServices>
控制使用 ASP.NET 创建的 XML Web services 的设置。--|--<protocols>--|--<add> 元素
属性
值
说明
name
要添加的协议的名称,该协议可用于解密或反序列化 XML Web services 方法调用和关联的参数。
HttpGet
添加 HTTP GET 协议。方法名称和参数传入查询字符串,该查询字符串被追加到问号 (?) 后的请求 URL。
HttpPost
添加 HTTP POST 协议。方法名称和参数传入 HTTP 请求的自由格式区域。
HttpSoap
添加 HTTP SOAP 协议。
Documentation
添加特殊的 Documentation 协议。当启用该协议并直接请求 .asmx 页时,ASP.NET 运行 Helper 页以创建文档页,该文档页被传递到提出请求的客户端。
1 .1 <pages> 元素
<pages validateRequest="false" />
标识特定于页的配置设置
validateRequest:指示 ASP.NET 在从浏览器输入的所有内容中检查是否存在潜在的危险数据。如果是 true,则将所有输入数据与一个潜在危险值列表进行比较,从而执行请求验证。如果发生匹配,ASP.NET 将引发 HttpRequestValidationException 异常。
1 .2 <httpModules> 元素
<httpModules>
<add name="CommunitiesModule"type="ASPNET.StarterKit.Communities.CommunitiesModule,ASPNET.StarterKit.Communities"
>
/httpModules>
在一个应用程序内配置 HTTP 模块。
HttpModule:HttpModule 是实现 IHttpModule 接口和处理事件的程序集。ASP.NET 包含一组可由应用程序使用的 HttpModule 模块。例如,ASP.NET 提供了 SessionStateModule 来向应用程序提供会话状态服务。可以创建自定义 HttpModule 以响应 ASP.NET 事件或用户事件。
编写 HttpModule 的一般过程为:
实现 IHttpModule 接口。
处理 Init 方法并为所需事件进行注册。
处理该事件。
如果必须进行清理,还可根据需要实现 Dispose 方法。
在 Web.config 中注册该模块。
子标记
说明
<add>
将 HttpModule 类添加到应用程序。
请注意,如果以前已指定了相同的谓词/路径组合(例如在父目录的 Web.config 文件中),则对 <add> 的第二个调用将重写以前的设置。
<httpModules>
<add name="OutputCache"
type="System.Web.Caching.OutputCacheModule, System.Web,
Version=1.0.2800.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
</httpModules>
属性
说明
name
为模块提供一个好记的名称。这使您可为 global.asax 文件内的模块事件关联一个事件处理程序。
type
指定由版本、程序集和公钥标记组成的逗号分隔的类/程序集组合。ASP.NET 首先在应用程序的专用 /bin 目录中搜索程序集 DLL,然后在系统程序集缓存中搜索程序集 DLL。
<remove>
从应用程序移除 HttpModule 类。
<clear>
从应用程序移除所有 HttpModule 映射。
1 .3 <httpRuntime> 元素
<httpRuntime maxRequestLength="10000" />
配置 ASP.NET HTTP 运行库设置。该节可以在计算机、站点、应用程序和子目录级别声明。
属性
说明
maxRequestLength
指示 ASP.NET 支持的最大文件上载大小。该限制可用于防止因用户将大量文件传递到该服务器而导致的拒绝服务攻击。指定的大小以 KB 为单位。默认值为 4096 KB (4 MB)。
1 .4 <httpHandlers> 元素
<httpHandlers>
<add verb="*" path="*.jpg" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
<add verb="*" path="*.jpeg" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
<add verb="*" path="*.gif" type="ASPNET.StarterKit.Communities.ImageHandler, ASPNET.StarterKit.Communities" />
</httpHandlers>
<httpHandlers>
<remove verb="*" path="*.jpg" />
<remove verb="*" path="*.gif" />
</httpHandlers>
根据在请求中指定的 URL 和 HTTP 谓词,将传入的请求映射到适当的 IHttpHandler 或 IHttpHandlerFactory 类。
子标记
说明
<add>
指定映射到 IHttpHandler 或 IHttpHandlerFactory 类的谓词/路径。
属性
说明
verb
谓词列表可以是逗号分隔的 HTTP 谓词列表(例如“GET, PUT, POST”),也可以是开始脚本映射(例如通配符 * [星号])。
path
路径属性可以包含单个 URL 路径或简单的通配符字符串(例如 *.aspx)。
type
指定逗号分隔的类/程序集组合。ASP.NET 首先在应用程序的专用 /bin 目录中搜索程序集 DLL,然后在系统程序集缓存中搜索程序集 DLL。
<remove>
移除映射到 IHttpHandler 类的谓词/路径。<remove> 指令必须与上一个 <add> 指令的谓词/路径组合精确匹配。该指令不支持通配符。
<clear>
移除当前配置的或由指定 Web.config 文件继承的所有 IHttpHandler 映射。
1 .5 <webServices> 元素
<webServices>
<protocols>
<add name="HttpGet"/>
</protocols>
</webServices>
控制使用 ASP.NET 创建的 XML Web services 的设置。--|--<protocols>--|--<add> 元素
属性
值
说明
name
要添加的协议的名称,该协议可用于解密或反序列化 XML Web services 方法调用和关联的参数。
HttpGet
添加 HTTP GET 协议。方法名称和参数传入查询字符串,该查询字符串被追加到问号 (?) 后的请求 URL。
HttpPost
添加 HTTP POST 协议。方法名称和参数传入 HTTP 请求的自由格式区域。
HttpSoap
添加 HTTP SOAP 协议。
Documentation
添加特殊的 Documentation 协议。当启用该协议并直接请求 .asmx 页时,ASP.NET 运行 Helper 页以创建文档页,该文档页被传递到提出请求的客户端。
- 上一篇: 常用的读写ini文件的类
- 下一篇: 利用Jmail发送和接收邮件(C#)
-= 资 源 教 程 =-
文 章 搜 索