web.config配置详细说明

标签：

 <configuration>//顶层元素
<system.web>//大多应用程序设置位于此元素下
<sessionState mode=‘Inproc‘ timeout=‘10‘ />//设置会话状态超时时间
</system.web>
</configuration>

Table 3-1.可用于web.config的顶层配置元素

1, 配置的四个层次

(1)机器:machine.config:位于$FRAMEWORK\CONFIG($FRAMEWORK一般是c:\winnt\Microsoft.NET\Framework\v1.0.3705)，
是.net必须备的默认配置文件。
web.config用来修改.net默认配置。
(2)站点:web站点根目录下的web.config，影响全站配置
(3)程序:应用程序虚目录根下的web.config，影响全虚目录配置
(3)子目录:虚目录的子目录下的web.config，影响该子目录及其子目录下配置

Figure 3-1. Hierarchy of Configuration Files

[图片]

2，通过location元素简化web.config配置:

Listing 3-2 Using the location Element

<configuration>
<location path="bar">//作用就相当于在bar目录下配置了指定的web.config配置
<system.web>
<httpHandlers>
<remove verb="*" path="*.ashx" />
</httpHandlers>
</system.web>
</location>
</configuration>


3，元素的配置规定:
authentication, sessionState, trust, 和 httpModules(即使在老版本.net允许在子目录中配置，也是不生效的)元素属于应用程序级别的元素，不能配置于子目录下的 web.config。processModel属于机器级别元素，只能用于machine.config。

4，元素的更改生效时间:
一般web.config更改后，会自动重新加载程序，并放弃原进程的会话状态和程序状态。如果是processModel更改，只有终止工作者进程(可手工IIS复位，可撤销aspnet_wp.exe进程，也可因进程意外反弹自身)然后重新启动，才能应用新配置，同时放弃所有运行于该机器上的.net 程序状态，缓存数据和会话状态。

5,IIS与web.config配置
如果使用了IIS，则IIS的安全配置等优秀于.net配置。如此可以只使用IIS默认配置，而在web.config中具体配置。

二，常量配置appSettings
使用appSettings元素的add子元素的key和value属性(键值不分大小写)来存储常量设置。

Listing 3-3 Specifying Application-Specific Configuration Data

<!— File: web.config —>
<configuration>
<appSettings>
<add key="DSN"
value="server=localhost;uid=sa;pwd=;database=pubs"
/>
<add key="bgColor" value="white" />
</appSettings>
</configuration>
程序启动后，配置就载入内存，有访问权限(.net使用HttpForbiddenHandler来控制对.config.cs, .vb, .asax, .resx文件的访问权限，默认下外部程序不可访问配置文件)的程序就可以使用ConfigurationSettings.AppSettings ["DSN"]的方式直接引用配置的值。

Listing 3-4 Retrieving appSettings Configuration Data

<!— File: samplepage.aspx —>
<%@ Page Language=‘C#‘ %>
<%@ Import Namespace=‘System.Configuration‘ %>

<script runat=server>
protected void Page_Load(object src, EventArgs e)
{
string dsn = ConfigurationSettings.AppSettings["DSN"];
// use dsn to connect to a database...

string bgColor =
ConfigurationSettings.AppSettings["bgColor"];
// use retrieved background color...
}
</script>

<!— remainder of page not shown —>

三，进程配置processModel
只能在machine.config中使用processModel，其改动只在aspnet_wp.exe进程重启后生效，并由unmanaged (非托管?)的aspnet_isapi.dll(ISAPI扩展dll)读取，而非象其他配置一样由managed mechanism(托管机制?)读取。

Table 3-2. Attributes of the processModel Element

　　虽然如上有众多条件能使进程反弹，但默认下只有两个反弹条件：一是程序占用了60%以上的物理内存(该条件由memoryLimit属性来指定)，二是有5000多个请求在队列中等待。常用的反弹条件还有明确的超时时间 (timeout),空闲超时时间(累计空闲时间idleTimeout),工作者进程的服务数量上限(requestLimit)。
　　可以通过设置webGarden和 cpuMask来设置多cpu的使用方式

Listing 3-5 Specifying Multiple Worker Processes on a Multi-CPU machine

<processModel enable="true"
timeout="Infinite"
idleTimeout="Infinite"
shutdownTimeout="0:00:05"
requestLimit="Infinite"
requestQueueLimit="5000"
restartQueueLimit="10"
memoryLimit="60"
webGarden="true"//启用该配置后，每个cpu运行一个工作者进程，进程间不能共享会话状态，数据缓存，程序状态
cpuMask="0x00000007"//相当于二进制0...0111屏蔽，则只使用cpu0,cpu1,cpu2，屏蔽其他cpu
userName="machine"
password="AutoGenerate"
logLevel="Errors"
clientConnectedCheck="0:00:05"
comAuthenticationLevel="Connect"
comImpersonationLevel="Impersonate"
responseRestartDeadlockInterval="00:09:00"
responseDeadlockInterval="00:03:00"
maxWorkerThreads="25"
maxIoThreads="25" />


　　还可以设置maxIoThreads和maxWorkerThreads来控制CPU。(前者一定是I/O(如流或管道)实现端口，后者则是传统非限制流程。由于目前IIS采用异步写已命名管道的方法来处理请求(IIS6直接集成了asp.net，所以不必通过已命名管道而是在工作者线程中直接处理请求)，所以.net主要也在I/O中处理请求。)默认的线程设置是25/CPU，一般已经够用。当需要设置超过25直到100线程时,需要谨慎检查是否有异常。

1, 读取进程信息
使用ProcessModelInfo(两个获得当前或刚终止工作者进程休息的方法，都调用ProcessInfo类)和ProcessInfo(保存工作者进程的信息)两个静态类来读取进程信息

Listing 3-6 ProcessModelInfo and ProcessInfo Classes

public class ProcessModelInfo
{
public static ProcessInfo GetCurrentProcessInfo();
public static ProcessInfo[] GetHistory(int num);
}

public class ProcessInfo
{
public TimeSpan Age {get;}//年龄
public int PeakMemoryUsed {get;}//已使用最大内存数
public int ProcessID {get;}//进程ID
public int RequestCount {get;}//已服务的请求数
public ProcessShutdownReason ShutdownReason {get;}//关闭原因
public DateTime StartTime {get;}//开始时间
public ProcessStatus Status {get;}//状态
}

Figure 3-3. Sample ProcessModelInfo Output

[图片]

2 , IIS6.0进程模型的改变(相对IIS5的隔离方式)
　　在IIS6.0中，ProcessModel在IIS元数据库中被对等设置代替，现在以XML形式放在metabase.xml文件中，所以忽略了 machine.config中的ProcessModel元素。而且进程不再是ASPNET_wp.exe，而是一个或多个w3wp.exe中，因为已经不限制一个cpu只能一个工作者进程。我们可以配置应用程序池(包含共享相同工作者进程的虚目录集)，通过比ProcessModel更多更灵活的设置来控制进程(循环次数/天，分离虚拟内存极限，实际内存极限，cpu使用监视，cpu过载的回收，应用程序池禁用的错误数量极限，启动和关闭时间限制)。
　　另外，使用http.sys的内核模式来侦听处理Http请求，而不再是inetinfo.exe。这样就不在进程中而是在系统服务内核中处理Http要求，于是即使用户模式进程出现缺陷甚至崩溃，都不会影响服务内核。

四，附属设置

1，assemblies元素
　　在web.config中使用@Assembly，可以全局引用GAC部署的应用程序。

Listing 3-7 Adding an Application-wide Reference to a GAC-Deployed Assembly

<configuration>
<!— ... —>
<system.web>
<compilation>
<assemblies>
<add assembly="Util, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a77a5c561934e089" />
</assemblies>
</compilation>
</system.web>
</configuration>
2，pages元素
　　在web.config中使用@page指令，可以统一改变应用程序的page默认设置。

Listing 3-8 Using the pages Element

<configuration>
<!— ... —>
<system.web>
<pages enableViewState=‘false‘ />
</system.web>
</configuration>
五，读取配置信息
　　除了通过ConfigurationSettings.AppSettings["xxx"]来访问保存在AppSettings中的值外，通常用 ConfigurationSettings.GetConfig()方法，请求从缓存中读取，如未缓存就请求直接从配置文件读入内存， ConfigurationRecord类使用XmlTextReader类可以直接读取最低层配置的物理xml文件。

Listing 3-9 Reading Configuration Settings

object settings =
ConfigurationSettings.GetConfig("appSettings");
NameValueCollection nvc = settings as NameValueCollection;
if (nvc != null)
{
string val = (string)nvc["xxx"];
}

除了web.config这样的配置的元数据，还有配置的处理程序(解析配置使其获得高扩展性，并在正式读取配置时建立类，同时传送对象的实例建立，开始传送相关配置)。如下图：machine.config中，compilation元素由 CompilationConfigurationHandler类来解析，该类于configSections元素下指定，同时也属于 sectionGroup元素(进一步确定分析范围是 system.web)。另外一个元素appSettings由NameValueFileSectionHandler负责解析，该元素位于配置文件的顶层。

Figure 3-4. Configuration Section Handlers in machine.config

[图片]

每个configSections中的元素都必须实现IConfigurationSectionHandler接口，该接口有一个简单的方法 Create。当配置处理程序的标签被读入时，ConfigurationRecord类(顶层配置文件解析器)调用Create方法。同时，处理程序获得上层配置信息(如果有上层配置的话)和当前HttpConfigurationContext对象(通过输入参数)，以及对 XmlNode的引用(最重要信息，由配置处理程序负责解析)。通常处理程序(函数)会遍历XmlNode的每个子节点和属性，返回一个对象，包含所有状态信息。在缓存上述状态信息后，应用程序就可通过ConfigurationSettings.GetConfig()全局引用该状态信息。

Listing 3-10 IConfigurationSectionHandler Interface

public interface IConfigurationSectionHandler
{
object Create(object parent, object input, XmlNode node);
}
asp.net配置部份的处理程序各自都会在内存中建立一个state retainer(状态保持器)，如CompilerConfiguration类(compilation元素信息)， PagesConfiguration类(pages元素信息 )等。这些配置实例类(都是内部类，不可直接访问，asp.net用它们来设置其创建类中的默认值和其它值)都保存在一个全局的哈希表中，可以用 ConfigurationSettings.GetConfig()来访问该哈希表。

Figure 3-5. In-memory Configuration Settings Layout

[图片]

六，创建自定义的配置处理程序
除了保存在appSettings元素中之外，还可以自定义配置元素。如下:

Listing 3-11 Sample Custom Configuration Element

<!— File: web.config —>
<configuration>
<acmeGroup>
<acme>//指定自定义元素
<font>Courier New</font>
<backgroundColor>Green</backgroundColor>
<underlineLinks>true</underlineLinks>
<horizontalWidth>600</horizontalWidth>
<verticalWidth>800</verticalWidth>
</acme>
</acmeGroup>
</configuration>
首先，我们要建立用于保存配置状态信息的保存机制。
一种较简单的方法是定义一个类(如AcmeSettings类)，用其中的公有数据成员来保存对应的配置元素。

Listing 3-12 Sample Custom Configuration Settings State Class

// File: AcmeSettings.cs
namespace EssentialAspDotNet.Config
{
public class AcmeSettings
{
public string Font;
public string BackgroundColor;
public bool UnderlineLinks;
public int HorizontalWidth;
public int VerticalWidth;
}
}
然后，我们要建立一个实现IConfigurationSectionHandler接口的类，用于解析配置文件中自定义部份，并将其状态信息保存到acmeSettings类中。

Listing 3-13 Sample Custom Configuration Section Handler

// File: AcmeConfigHandler.cs
namespace EssentialAspDotNet.Config
{
public class AcmeConfigHandler :
IConfigurationSectionHandler
{
public object Create(object parent, object input,
XmlNode node)
{
AcmeSettings aset = new AcmeSettings();

foreach (XmlNode n in node.ChildNodes)
{
switch (n.Name)
{
case ("font"):
aset.Font = n.InnerText;
break;
case ("backgroundColor"):
aset.BackgroundColor = n.InnerText;
break;
case ("underlineLinks"):
aset.UnderlineLinks = bool.Parse(n.InnerText);
break;
case ("horizontalWidth"):
aset.HorizontalWidth = int.Parse(n.InnerText);
break;
case ("verticalWidth"):
aset.VerticalWidth = int.Parse(n.InnerText);
break;
}
}
return aset;
}
}
}
最后要通知，我们要用该类解析配置文件中的acme元素。为此，我们在配置文件的configSections中添加一个section元素，用于读取并解析配置文件。(系统范围的machine.config文件，站点范围和应用程序范围的web.config文件都能添加Section元素)

Listing 3-14 Installing a Custom Configuration Section Handler

<!— File: web.config —>
<configuration>
<configSections>
<sectionGroup name="acmeGroup">
<section name="acme"
type="EssentialAspDotNet.Config.AcmeConfigHandler, AcmeConfigHandler"
/>
</sectionGroup>
</configSections>
<!— ... —>
</configuration>
现在，应用程序中的所有网页或者代码块，都能使用ConfigurationSettings.GetConfig()方法访问该配置信息，传递我们创建的部份组(section group)和部份名称(section name)，并将结果转变为我们创建的AcmeSettings类。如下:

Listing 3-15 Accessing Custom Configuration Information

// File: TestAcmeSettings.aspx
protected void Page_Load(object src, EventArgs e)
{
AcmeSettings set;
set = ConfigurationSettings.GetConfig("acmeGroup/acme")
as AcmeSettings;

// use set here (like set.Font, set.BackgroundColor,
// etc.)
}
还有一种方法，使用NameValueFileSectionHandler，就不需要自即编写实现 IConfigurationSectionHandler接口的类了，而是重用与appSettings元素一样的类。当然也不能用add元素(带有键 /值对)添加新的配置元素，但也能容易地添加新的配置部份。

Listing 3-16 Adding a Custom Configuration Section with a Prebuilt Handler

<!— File: web.config —>
<configuration>
<configSections>
<section name="myGroup"
type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.3300.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089"/>//添加了名为myGroup的新的配置的部份
///其type属性引用了NameValueFileSectionHandler类，该类的实例将其键/值对保存在NameValueCollection中供访问。

</configSections>

<myGroup>
<add key="font" value="Courier New"/>
<add key="backgroundColor" value="Green"/>
<add key="underlineLinks" value="true"/>
<add key="horizontalWidth" value="600"/>
<add key="verticalWidth" value="800"/>
</myGroup>
<!— ... —>
</configuration>

Listing 3-17 Accessing Custom Configuration Information with NameValueCollection

// File: TestAcmeSettings.aspx
protected void Page_Load(object src, EventArgs e)
{
NameValueCollection set;
set = ConfigurationSettings.GetConfig("myGroup")
as NameValueCollection;

// use set here (like set["Font"],
// set["BackgroundColor"], etc.)
}
七，小结：
ASP.NET使用web.config名字的XML文件取代IIS的元数据库进行配置，machine.config是最顶层的机器配置，而web.config可以放在站点根目录，虚目录根部，子目录等不同层次位置，相应地对其下层发生效用。
另外还可用新的配置元素，appSettings用于保存数据的通用的名/值对，以供应用程序调用。processModel可以精确控制工作者进程。另外还可通过写一个实现IConfigurationSectionHandler接口的类或者使用系统提供的 NameValueFileSectionHandler类，实现自定义配置。

web.config配置详细说明

标签：

原文地址：http://www.cnblogs.com/Alex80/p/5463931.html