Search KB Filter article types
Understanding the Web.config file
Categories: Configuration
Tags: Architects, Developers, XML, Non English Cultures, 1. Beginner, 2. Intermediate, 3. Advanced, ASP.NET, Pre v6.3, v6.3, v6.4 and Later
Revision: 2
Posted: 02/Aug/2010
Updated: 07/July/2011
Status: Publish
Types: Reference

This article is being worked on by Gizmox.
Overview

This article explains the use and purpose of the various sections used in the Web.config file.

See alsoSections"configSections"
<section name="WebGUI" type="Gizmox.WebGUI.Common.Configuration.ConfigHandler, Gizmox.WebGUI.Common, Version=2.0.5701.0, Culture=neutral, PublicKeyToken=263fa4ef694acff6"/>

The above section is taken from a Net2.0 Visual Studio 2005 Visual WebGui Application Web.config.
In Net3.5 Visual Studio 2008 the value of the "Version" attribute would be: "3.0.5701.0".
In Net4.0 Visual Studio 2010 the value of the "Version" attribute would be: "4.0.5701.0".

Purpose

Registers the "Gizmox.WebGUI.Common.Configuration.ConfigHandler" class to handle the interpretation of the "WebGUI" Web.config section.

"WebGUI"Purpose

Acts as a container for the Visual-WebGui-specific configurations.

Sub-sections

Applications
Controls
Directories
Languages
SilverlightPackages
Themes

Sub-elements

AnimationEnabled
AspCompat
ForceHTTPS
ForcePageInstance
GZipCompression
InlineWindows
ModalWindows
PngSupport
Forms PreReleaseDockFillCompatibility
PrivateVersion
ShowLGPLWaiver
SilverlightExtension
StaticResources
TimersEnabled
Windows FormsCompatible


"system.web" -> "httpHandlers"
<add verb="*" path="*.wgx" type="Gizmox.WebGUI.Server.Router,Gizmox.WebGUI.Server,Version=2.0.5701.0,Culture=neutral,PublicKeyToken=3de6eb684226c24d" />

The above section is taken from a Net2.0 Visual Studio 2005 Visual WebGui Application Web.config.
In Net3.5 Visual Studio 2008 the value of the "Type" attribute would be: "Gizmox.WebGUI.Server.Router,Gizmox.WebGUI.Server,Version=3.0.5701.0,Culture=neutral,PublicKeyToken=3de6eb684226c24d".
In Net4.0 Visual Studio 2010 the value of the "Type" attribute would be: "Gizmox.WebGUI.Server.Router,Gizmox.WebGUI.Server,Version=4.0.5701.0,Culture=neutral,PublicKeyToken=3de6eb684226c24d".

Purpose

This element is there to register the Visual WebGui Gizmox.WebGUI.Server.Router class to handle incoming requests that are received by IIS and directed to the virtual-directory where this Web.config is located.
The router class knows how to interpret the URL of the GET or POST HTTP initial request and the arguments sent if any. After interpreting the URL, the Router loads the Visual WebGui resources to the client and then loads the requested/relevant Form.
For more information about this, you can view this article here.


"system.diagnostics" -> "switches"


A container for Visual WebGui specific configurations.

ShowDebugger
<add name="VWG_ShowDebuggerSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled
More information here.

DisableObscuring
<add name="VWG_DisableObscuringSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled

DisableCaching
<add name="VWG_DisableCachingSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled

ShowClientErrors
<add name="VWG_ShowClientErrorsSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled

SessionTracing
<add name="VWG_SessionTracingSwitch" value="0" />

value:
0 - Disabled
1 - Trace registration and unregistration
2 - Trace registration count on end of request
4 - Trace context creation and destruction

Tracing
<add name="VWG_TracingSwitch" value="0" />

value:
0 - Disabled
1 - Gives error messages
2 - Gives errors and warnings
3 - Gives more detailed error information
4 - Gives verbose trace information

TracingThreshold
<add name="VWG_TracingThresholdSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled

EnableClientShortcuts
<add name="VWG_EnableClientShortcutsSwitch" value="0" />

value:
0 - Disabled,
1 - Enabled

Non Visual WebGui Sections"system.web" -> "sessionState"

MSDN article here.
CodeProject article here

"system.web" -> "globalization"

MSDN article here.
List of locales (cultures) here.

ReferencesRelated ArticlesForum

About the author

Related Articles

Configuration  
Title Update Author
Visual WebGui version 6.2 features complete integration into the Microsoft Visual Studio development system, a consolidated installation process, and the opportunity to use Microsoft Visual Studio Express Editions for software evaluation and trials. Attend this webcast to learn how the Visual WebGui...
Tags: Developers, Visual WebGui Pipeline, Visual Studio, 1. Beginner, 2. Intermediate, 3. Advanced, Integration, Pre v6.3, v6.3, v6.4 and Later
11/Jan/2008    2008/01/11
Tags: Developers, 2. Intermediate, 3. Advanced, Customization, WCF, Pre v6.3, v6.3, v6.4 and Later
06/Jan/2009    2009/01/06
Tags: Architects, Developers, XML, 1. Beginner, 2. Intermediate, 3. Advanced, Pre v6.3, v6.3, v6.4 and Later
29/Oct/2010    2010/10/29
Tags: Architects, Developers, XML, 1. Beginner, 2. Intermediate, 3. Advanced, Pre v6.3, v6.3, v6.4 and Later
23/July/2010    2010/07/23
Tags: Architects, Developers, XML, 1. Beginner, 2. Intermediate, 3. Advanced, Pre v6.3, v6.3, v6.4 and Later
23/July/2010    2010/07/23
Tags: Architects, Developers, XML, 1. Beginner, 2. Intermediate, 3. Advanced, Pre v6.3, v6.3, v6.4 and Later
23/July/2010    2010/07/23
.NET Web, Cloud and Mobile application delivery platform | Sitemap | Terms of Use | Privacy Statement | Copyright © 2005-2011 Visual WebGui®       Visual WebGui weblog on ASP.NET Visual WebGui Group on LinkedIn Visual WebGui updates on Twitter Visual WebGui Page on Facebook Visual WebGui YouTube Channel Visual WebGui Platform News RSS