INFO : Présentation de la Configuration ASP.NET

Cet article fait référence à l’espace de noms bibliothèque de classes Microsoft.NET Framework suivant :

  • System.Configuration

Résumé

Cet article fournit une introduction à l’infrastructure de page ASP.NET.

Pour les autres vues d’ensemble ASP.NET, reportez-vous à l’article suivant de la Base de connaissances Microsoft :
INFORMATIONS de 305140 : feuille de route de ASP.NET

Plus d'informations

La configuration implique de paramètres d’application telles que les connexions de base de données pour des détails sur la sécurité et des informations sur la façon dont les erreurs doivent être gérées. Fichiers de configuration fournissent un emplacement pour les informations spécifiques à l’ordinateur et spécifiques à l’application que vous pouvez modifier sans avoir à recompiler le code.

Cet article traite les rubriques suivantes de la configuration :

Configuration : Nouveautés

Contrairement aux paramètres de l’application Active Server Pages (ASP) qui sont stockées dans la métabase Microsoft Internet Information Services (IIS), les paramètres de configuration ASP.NET sont stockées dans les fichiers de langage de balisage Extensible (XML). Il offre les avantages suivants lorsque vous devez modifier les paramètres de configuration et le déploiement des applications :
  • Les fichiers de configuration ASP.NET sont stockées dans le même répertoire que le contenu du site. Au moment du déploiement, vous devez copier le répertoire de contenu pour obtenir du contenu et configuration de l’application.
  • Vous pouvez utiliser l’éditeur de texte standard pour modifier les fichiers de configuration. Cela facilite la modification des paramètres de configuration à la fois localement et à distance.
  • Les fichiers de configuration sont extensibles ; Par conséquent, vous pouvez ajouter vos propres paramètres de configuration personnalisés.
  • Le système détecte automatiquement les modifications apportées aux fichiers de configuration ASP.NET. Vous n’avez pas à redémarrer les services IIS ou redémarrer le serveur Web pour que les paramètres prennent effet.

Format de fichier et de la hiérarchie de Configuration

Il existe deux types de fichiers de configuration dont vous devez être concernés pour les applications ASP.NET : Machine.config et Web.config. Les deux fichiers sont basés sur XML et contiennent les sections de configuration similaire. Toutefois, le fichier Machine.config contient les informations de configuration sur toutes les applications .NET pour une version spécifique de framework, tandis que les fichiers Web.config contiennent les paramètres de configuration plus granulaires sur les applications ASP.NET spécifiques. Le texte dans les fichiers Machine.config et Web.config respecte la casse.

Pour plus d’informations sur le format des fichiers de configuration ASP.NET, reportez-vous à la rubrique suivante dans la documentation du Kit de développement logiciel (SDK) de.NET Framework :
Format des fichiers de Configuration ASP.NET
http://msdn2.microsoft.com/en-us/library/ackhksh7(vs.71).aspx
Lorsqu’une demande pour une page .aspx est effectuée, les fichiers de configuration sont compilés de manière à ce qu’un paramètre de configuration dans un fichier Web.config qui est stocké dans un sous-répertoire substitue à un paramètre dans un fichier Web.config dans un répertoire de l’application, qui remplace les paramètres au niveau du site Web et les paramètres dans le fichier Machine.config. Une fois les paramètres de configuration sont compilés, ils sont mis en cache pour les demandes ultérieures jusqu'à ce qu’un des fichiers de configuration est modifié.

Le tableau suivant répertorie les emplacements de fichier de configuration exemple pour l’URL http://myserver/myapplication/mydir/mypage.aspx :

NiveauChemin d’accès
Paramètres de configuration pour cette version de la de.NET FrameworkWinnt\Microsoft.net\Framework\v.version\Config\Machine.config
Paramètres de site WebInetpub\Wwwroot\Web.config
Paramètres de l’applicationInetpub\Wwwroot\Myapplication\Web.config
Paramètres de sous-répertoireInetpub\Wwwroot\Myapplication\Mydir\Web.config

Un fichier Web.config au niveau de n’importe quel est facultatif, mais un fichier Machine.config est requis.

Pour plus d’informations sur la hiérarchie de configuration, reportez-vous à la rubrique suivante dans la documentation du Kit de développement logiciel.NET Framework :
Architecture de Configuration hiérarchique
http://msdn.microsoft.com/en-us/library/aa720128(v=vs.71).aspx
Pour appliquer les paramètres de configuration à des ressources spécifiques, utilisez une balise < emplacement > avec un attribut path approprié. Vous pouvez utiliser l’attribut path pour identifier un répertoire de fichier ou enfant spécifique auquel des paramètres de configuration uniques s’appliquent.

Pour plus d’informations sur la balise < emplacement > , reportez-vous à la rubrique suivante dans la documentation du Kit de développement logiciel.NET Framework :
Paramètres de configuration < emplacement >
http://msdn.microsoft.com/en-us/library/6hbkh9s7(v=vs.71).aspx

Sections de Configuration ASP.NET

Les sections de configuration ASP.NET sont contenues dans la section < system.web > , qui est contenue dans la balise < configuration > :
   <configuration>      <appSettings></appSettings>
<system.web>
...
<webServices></webServices>
</system.web>
</configuration>

Le tableau suivant répertorie toutes les sections de configuration ASP.NET :

SectionDescription
Configure des paramètres personnalisés pour une application. Les paramètres de cette section peuvent être comparées aux variables d’application.
Configure le mode d’authentification pour déterminer le type d’authentification à utiliser.
Configure la prise en charge de l’autorisation et contrôle l’accès client aux ressources URL.
Configure les paramètres des fonctionnalités du navigateur.
Configure tous les paramètres de compilation qu’ASP.NET utilise.
Fournit des informations sur les messages d’erreur personnalisés pour une application ASP.NET.
Configure les paramètres de globalisation de l’application.
Mappe des demandes d’URL entrantes aux classes IHttpHandler .
Ajoute, supprime ou efface des modules HTTP au sein d’une application.
Configure les paramètres d’exécution HTTP d’ASP.NET.
Contrôle l’identité de l’application Web.
Configure des clés à utiliser pour le chiffrement et le déchiffrement des données de cookie d’authentification par formulaires. Cette section vous permet de configurer une clé de validation qui effectue des vérifications d’authentification de messages sur des données d’état d’affichage et les tickets d’authentification de formulaires.
Identifie les paramètres de configuration spécifiques à la page.
Configure les paramètres de modèle de processus ASP.NET sur les systèmes de serveur Web IIS. Notez que vous pouvez uniquement utiliser cette balise dans le fichier Machine.config.
Définit des mappages valides de niveaux de sécurité nommés vers des fichiers de stratégie.
Configure le module d’état de session.
Configure le service de trace ASP.NET.
Configure le jeu d’autorisations de sécurité d’accès au code qui est utilisé pour exécuter une application particulière.
Contrôle les paramètres d’ASP.NET Web Services.

Lors de la récupération des informations de Configuration

Vous pouvez récupérer des informations qui sont stockées dans le fichier de configuration, mais les méthodes varient pour les paramètres de configuration différents. Certains paramètres sont exposés en tant que propriétés des objets intrinsèques, et autres paramètres ne sont pas accessibles car ils sont des paramètres internes à ASP.NET.

Par exemple, vous pouvez utiliser le code suivant pour accéder aux paramètres < browserCaps > par le biais de l’objet Request.Browser :

Microsoft Visual Basic .NET
Response.Write(Request.Browser.VBScript.ToString())
Microsoft Visual C# .NET
Response.Write(Request.Browser.VBScript.ToString());
Pour plus d’informations sur la façon de récupérer les paramètres de configuration, reportez-vous à la rubrique suivante dans la documentation du Kit de développement logiciel.NET Framework :
L’accès aux paramètres de Configuration
http://msdn.microsoft.com/en-us/library/4c2kcht0.aspx

Extension de la Section de Configuration

La fonctionnalité de configuration du.NET Framework est totalement extensible. Il existe deux façons dont vous pouvez étendre configuration :
  • Créez un gestionnaire de section de configuration personnalisée.

    Pour plus d’informations sur la création de gestionnaires de section de configuration ASP.NET personnalisés, cliquez sur le numéro ci-dessous pour afficher l’article correspondant dans la Base de connaissances Microsoft :
    309045 Comment : créer un gestionnaire de Section de Configuration ASP.NET personnalisés dans Visual C# .NET
  • Utilisez la section < appSettings > pour stocker les données spécifiques de l’application. Pour plus d’informations sur la syntaxe de la section < appSettings > , reportez-vous à la rubrique suivante dans la documentation du Kit de développement logiciel.NET Framework :Pour récupérer les valeurs de la section < appSettings > , utilisez le code suivant dans le fichier .config :
            <appSettings><add key="MySetting" value="Valuable Information" />
    </appSettings>

    Puis, utilisez le code suivant pour récupérer la valeur :

    Remarque: vous devez inclure l’espace de noms System.Configuration pour accéder appSettings.

    Visual Basic .NET
        Label1.Text = ConfigurationSettings.AppSettings.Item("MySetting")
    Visual C# .NET
        Label1.Text = ConfigurationSettings.AppSettings["MySetting"];
Propriétés

ID d'article : 307626 - Dernière mise à jour : 27 janv. 2017 - Révision : 1

Commentaires