Difference between <system.web> and <system.webServer>?

danmine picture danmine · Dec 10, 2008 · Viewed 66.4k times · Source

Every time I have to add a handler or module for ASP.NET with IIS7, the instructions always tell me to incorporate it into two sections: system.web and system.webserver.

<system.web>
    <httpHandlers>
    </httpHandlers>
    <httpModules>
    </httpModules>
</system.web>

And this:

<system.webServer>
    <modules>
    </modules>
    <handlers>
    </handlers>
</system.webServer>

What is the difference between these two sections?

In addition, if I don't add it to the system.web section, my Visual Studio 2008 debugger also doesn't work correctly.

Answer

Chris picture Chris · Dec 10, 2008

The system.web section is for configuring IIS 6.0, while the system.webserver version is used to configure IIS 7.0. IIS 7.0 includes a new ASP.NET pipeline and some configuration differences, hence the extra config sections.

However...

If you're running IIS 7.0 in integrated mode only, you shouldn't need to add the handlers to both sections. Adding it to system.web as well is a fallback for IIS 7.0 operating in classic mode, unless I'm mistaken. I've not done extensive testing on this.

See http://msdn.microsoft.com/en-us/library/bb763179.aspx for more information.