Explication détaillée du fichier de configuration ASP.NET Web.config

Analyse :

Informations de configuration de l'application Web .NET (telles que la méthode d'authentification la plus couramment utilisée pour configurer l'application Web ASP.Net), qui peuvent apparaître dans chaque répertoire de l'application. Lorsque vous créez une nouvelle application Web via VB.NET, un fichier Web.config par défaut sera automatiquement créé dans le répertoire racine par défaut, y compris les paramètres de configuration par défaut, et tous les sous-répertoires hériteront de ses paramètres de configuration. Si vous souhaitez modifier les paramètres de configuration d'un sous-répertoire, vous pouvez créer un nouveau fichier Web.config dans le sous-répertoire. Il peut fournir des informations de configuration en plus des informations de configuration héritées du répertoire parent, et peut également remplacer ou modifier les paramètres définis dans le répertoire parent.
Les modifications apportées au fichier Web.config pendant l'exécution prendront effet sans redémarrer le service (Remarque : exception dans la section ). Bien entendu, le fichier Web.config est extensible. Vous pouvez personnaliser de nouveaux paramètres de configuration et écrire des gestionnaires de section de configuration pour les gérer.

1. Fichier de configuration web.config (paramètres de configuration par défaut)

Tous les codes suivants doivent être situés entre les codes suivants Par souci de simplicité, les exemples suivants sont omis. Cette balise XML.

< configuration>
  < system.web>
  < /system.web>
< /configuration>

1. Section

Fonction : Configurer la prise en charge de l'authentification ASP.NET (pour Windows, Forms, PassPort, Aucun). Cet élément ne peut être déclaré qu'au niveau de l'ordinateur, du site ou de l'application. L'élément doit être utilisé avec la section

par exemple : L'exemple suivant est un site de configuration d'authentification basé sur un formulaire Lorsqu'un utilisateur qui n'est pas connecté accède à une page Web qui nécessite une authentification, la page Web passe automatiquement à la page Web de connexion.

< authentication mode="Forms">
  < forms loginUrl="logon.aspx" name=".FormsAuthCookie"/>
< /authentication>

L'élément loginUrl représente le nom de la page Web de connexion et name représente le nom du cookie.

2. Section

Fonction : Contrôler l'accès du client aux ressources URL (par exemple, autoriser les utilisateurs anonymes à y accéder). Cet élément peut être déclaré à n'importe quel niveau (ordinateur, site, application, sous-répertoire ou page). Obligatoire en conjonction avec la section
Exemple : L'exemple suivant interdit l'accès aux utilisateurs anonymes

< authorization>
 < deny users="?"/>
< /authorization>

Remarque : Vous pouvez utiliser user.identity.name pour obtenir le nom d'utilisateur authentifié actuel, vous pouvez utiliser web.Security.FormsAuthentication ; La méthode redirige un utilisateur authentifié vers la page que l'utilisateur vient de demander.

3. Section

Fonction : Configurer tous les paramètres de compilation utilisés par ASP.NET. L'attribut de débogage par défaut est "True". Il doit être défini sur True une fois le programme compilé et livré pour utilisation (les instructions détaillées se trouvent dans le fichier Web.config, les exemples sont omis ici)

4, < customErrors>

Fonction : fournit des informations sur les messages d'erreur personnalisés pour les applications ASP.NET. Cela ne s'applique pas aux erreurs qui se produisent dans les services Web XML.
Exemple : lorsqu'une erreur se produit, accédez à la page Web vers une page d'erreur personnalisée.

< customErrors defaultRedirect="ErrorPage.aspx" mode="RemoteOnly"> 
< /customErrors>

L'élément defaultRedirect représente le nom de la page Web d'erreur personnalisée. L'élément mode signifie : afficher des informations personnalisées (conviviales) aux utilisateurs qui n'exécutent pas sur le serveur Web local.

5. Section

Fonction : Configurer les paramètres d'exécution HTTP ASP.NET. Cette section peut être déclarée au niveau de l'ordinateur, du site, de l'application et du sous-répertoire.
Exemple : contrôlez la taille maximale des fichiers téléchargés par l'utilisateur à 4 Mo, la durée maximale à 60 secondes et le nombre maximal de requêtes à 100.

6.

Fonction : identifie les paramètres de configuration spécifiques à la page (par exemple, s'il faut activer l'état de session, afficher l'état, détecter les entrées de l'utilisateur, etc.). peuvent être déclarés au niveau de l'ordinateur, du site, de l'application et du sous-répertoire.
Exemple : ne détectez pas s'il existe des données potentiellement dangereuses dans le contenu saisi par l'utilisateur dans le navigateur (Remarque : cet élément est défini par défaut sur la détection. Si vous utilisez la non-détection, vous devez d'abord encoder ou vérifier la saisie de l'utilisateur) , dans L'état d'affichage chiffré est vérifié lorsque la page est publiée depuis le client pour vérifier que l'état d'affichage n'a pas été falsifié du côté client. (Remarque : cet élément n'est pas vérifié par défaut)

< pages buffer="true" activateViewStateMac="true" validateRequest="false"/>

7, < ; sessionState>

Fonction : Configurer les paramètres d'état de session pour l'application actuelle (par exemple, définir s'il faut activer l'état de session et où enregistrer l'état de session).
Exemple :

< sessionState mode="InProc" cookieless="true" timeout="20"/>
< /sessionState>

注：
mode="InProc"表示：在本地储存会话状态（你也可以选择储存在远程服务器或SAL服务器中或不启用会话状态）
cookieless="true"表示：如果用户浏览器不支持Cookie时启用会话状态(默认为False）
timeout="20"表示：会话可以处于空闲状态的分钟数

8、

作用：配置 ASP.NET 跟踪服务，主要用来程序测试判断哪里出错。
示例：以下为Web.config中的默认配置：

< trace enabled="false" requestLimit="10" pageOutput="false" traceMode="SortByTime" localOnly="true" />

注：
enabled="false"表示不启用跟踪；requestLimit="10"表示指定在服务器上存储的跟踪请求的数目
pageOutput="false"表示只能通过跟踪实用工具访问跟踪输出；
traceMode="SortByTime"表示以处理跟踪的顺序来显示跟踪信息；
localOnly="true" 表示跟踪查看器 (trace.axd) 只用于宿主 Web 服务器；

9、

<system.webServer>
  <security>
   <requestFiltering>
    <requestLimits maxAllowedContentLength="2147483648"/>
   </requestFiltering>
  </security>
</system.webServer>

二、自定义Web.config文件配置节
自定义Web.config文件配置节过程分为两步。

一是在在配置文件顶部 和 标记之间声明配置节的名称和处理该节中配置数据的 .NET Framework 类的名称。

二是在 区域之后为声明的节做实际的配置设置。

示例：创建一个节存储数据库连接字符串

< configuration>  
 < configSections>  
  < section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
 < /configSections> 
 < appSettings>  
  < add key="scon" value="server=a;database=northwind;uid=sa;pwd=123"/>  
  < /appSettings>  
 < system.web>  
  ......  
 < /system.web>  
< /configuration>

三、访问Web.config文件

你可以通过使用ConfigurationSettings.AppSettings 静态字符串集合来访问 Web.config 文件示例：获取上面例子中建立的连接字符串。

四、创建Web.config文件

1.在“解决方案资源管理器”中，单击“刷新”图标以确认应用程序还没有 Web.config 文件。

如果已使用网站管理工具或某些其他方式来配置应用程序，则可能已自动创建了 Web.config 文件。单击“刷新”更新文件列表。

2.在“解决方案资源管理器”中，右击网站名称，然后单击“添加新项”。 
3.在“模板”窗口中，单击“Web 配置文件”

“名称”文本框中的文件名应为Web.config。可以为该文件提供其他名称，不过这是默认名称。.config 文件扩展名可防止 ASP.NET 下载相应文件。 
4.单击“添加”创建该文件，然后将其打开进行编辑。

该文件包含本主题后面“示例”部分中显示的代码，并具有一些初始默认值。应用程序从 %SystemRoot%\Microsoft.NET\Framework\<版本>\CONFIG 目录下的 Machine.config 和 Web.config 文件继承所有配置设置，但在此处看不到这些默认设置。如果要重写继承的默认设置或添加 httpHandlers 元素（ASP.NET 设置架构） 等集合元素，则只需创建应用程序级别和目录级别的 Web.config 文件。

若要查看当前应用程序的所有配置设置，可以运行主题如何：以编程方式查看继承的配置设置和本地配置设置中包含的代码。也可以查看 %SystemRoot%\Microsoft.NET\Framework\<版本>\CONFIG 目录下的Machine.config.comments 或 Web.config.comments 文件（这两个文件也包含有用的注释），但这两个文件将不会包含所有运行时设置，请参见如何：以编程方式查看继承的配置设置和本地配置设置。

5.如果更改了 Web.config 文件，则保存该文件。

保存 Web.config 文件会重新启动应用程序。也可以选择使用单个节元素的 configSource 属性指向某个辅助配置文件，更改辅助配置文件不会导致应用程序重新启动。有关更多信息，请参见节元素所继承的常规属性中的 configSource。

Web.config是asp.net应用程序中一个很重要的配置文件，通过Web.config文件可以方便我们进行开发和部署asp.net应用程序。通过本文的介绍，希望对你有帮助，供参考。

更多ASP.NET Web.config配置文件详解相关文章请关注PHP中文网！